The ASAPP API is Resource oriented, relying on REST principles. Our APIs accept and respond with JSON.

Authentication

The ASAPP API uses a combination of an API Id and API Secret to authenticate requests.
curl -X GET 'https://api.sandbox.asapp.com/conversation/v1/conversations' \
--header 'asapp-api-id: <API KEY ID>' \
--header 'asapp-api-secret: <API TOKEN>' \
Learn how to find your API Id and API Secret in the Developer quickstart.

Environments

The ASAPP API is available in two environments:
  • Sandbox: Use the Sandbox environment for development and testing.
  • Production: Use the Production environment for production use.
Use the API domain to make requests to the relevant environment.
EnvironmentAPI Domain
Sandboxhttps://api.sandbox.asapp.com
Productionhttps://api.asapp.com

Errors

The ASAPP API uses standard HTTP status codes to indicate the success or failure of a request.
Status CodeDescription
200OK
201Created
204No Content
400Bad Request
401Unauthorized
403Forbidden
404Not Found
429Too Many Requests
500Internal Server Error
We also return a code and message in the response body for each error. Learn more about error codes in the Error handling section.