Authentication

All API requests must include your API key as a Bearer token in the Authorization header.

Get your API key

  1. Log in to your CRM at app.pushbuttoncrm.com
  2. Go to Settings → Developer
  3. Click Generate API key
  4. Copy and store the key — it is only shown once

Request format

Include the key in every request as a Bearer token:

Authorization: Bearer YOUR_API_KEY

Full example with cURL:

curl https://app.pushbuttoncrm.com/api/v1/contacts \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

Tenant scoping

API keys are scoped to a single CRM tenant. All data returned is automatically filtered to your company. You cannot access data from another tenant regardless of which API key is used.

Error responses

StatusMeaning
401Missing or invalid API key
403Valid key but insufficient role permissions
429Rate limit exceeded — retry after 60 seconds

Roles

RolePermissions
ownerFull read/write access to all resources
adminRead/write contacts, deals, companies — cannot manage users
memberRead-only access to contacts and deals