API Client access keys

To create an api access key for a specific api client, the API expects a POST request, used for resources where there is no user available. Unlike other API requests, an authorization header is not needed.

This API resource is only available to Premium APPs.

POST Authentication/ApiClientAccessKeys

Example request

{
   "clientIdentifier": "81638f6b-2e84-4abb-ab61-634afb455d15",
   "clientSecret": "iaq2DGp243kYA2PcmuQYTqcQ26cBOFQ+t8U92S8JX1zZASnzwOmu680pFwVs/NPE2zoQDWzM0QSNdYRc"
}

The client identifier and client secret are send by email when the client application was registered with Basecone.

Example response

{
    "apiAccessKey":"76e8a07e-db7c-47c1-bc65-f39ef600b9ad"
}

Possible error responses

Status code	Error code	Details
400	client_credentials_invalid	The credentials of the specified client application are not valid.

• General
  • Authentication
  • Collections
  • Error handling
  • Optional fields
  • Common objects
• Resources
  • Access keys
  • Accounting systems
  • Authorization
  • Companies
  • Cost Centers
  • Cost Units
  • Customers
  • Documents
  • General Ledgers
  • Office
  • Periods
  • Projects
  • Suppliers
  • Transactions
  • Transaction proposals
  • Users
  • Vat Codes
  • Vat Specifications
  • Vat Periods
  • Webhook subscriptions
• Webhooks
  • Document events
  • Transaction events