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.

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.