Authentication

You'll need to authenticate your requests to access any of the endpoints in the Magistrate API using a bearer token. You must always pass a Content-Type header of application/json.

Bearer token authentication

When establishing a connection to the API, you will need your access token — you will find it in the Integrations panel under API token. Here's how to add the token to the request header using cURL:

Example request with bearer token

curl https://api.getmagistrate.com/v1/envelopes/.../ \
  -H "Authorization: Token {token}" \
  -H "Content-Type: application/json"

Always keep your token safe and reset it if you suspect it has been compromised.

Content-Type header is required

You must include the content type in the header of any POST request.

The only recognized content type is application/json. Anything else will be rejected:

Content-Type: application/json