Skip to main content
POST
/
auth
/
login
Authenticate and get API token
curl --request POST \
  --url https://www.postable.com/api/v1/auth/login \
  --header 'Content-Type: application/json' \
  --data '
{
  "app_id": "my-app",
  "email": "[email protected]",
  "password": "your-password"
}
'
{
  "data": {
    "token": "<string>"
  }
}

​
Overview

The login endpoint allows you to exchange your Postable credentials for a bearer token that can be used to authenticate subsequent API requests.
This is the only endpoint that does not require authentication. All other endpoints require a valid bearer token.

​
Token Management

  • Each app_id can have one active token at a time
  • Calling login with the same app_id will revoke the previous token and issue a new one
  • Use different app_id values if you need multiple active tokens (e.g., for different applications)

​
Using Your Token

Include the token in the Authorization header of all subsequent requests: 
curl -X GET "https://www.postable.com/api/v1/contacts" \
  -H "Authorization: Bearer YOUR_TOKEN_HERE"

Body

application/json
​
app_id
string
required

Identifier for your application (used to manage tokens)

​
email
string<email>
required

Your Postable account email

​
password
string
required

Your Postable account password

Response

Authentication successful

​
data
object