The FirstQuadrant API provides programmatic access to all the features of the FirstQuadrant CRM platform. This guide will help you get started with making your first API call.

​
Base URL

All API requests should be made to: 
https://api.us.firstquadrant.ai/v5

​
Authentication

Before making any API requests, you’ll need to authenticate. FirstQuadrant supports two authentication methods:
  1. API Keys - Best for server-to-server integrations
  2. Access Tokens - For user-specific actions
See the Authentication guide for detailed instructions on obtaining and using credentials.

​
Making your first request

Here’s a simple example to test your authentication and get your user profile: 
curl https://api.us.firstquadrant.ai/v5/me \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "FirstQuadrant-Organization-ID: org_YOUR_ORG_ID"

​
Response format

All successful API responses return JSON data. The response will vary based on the endpoint, but typically follows these patterns:

​
Single resource

{
  "id": "con_abc123",
  "email": "[email protected]",
  "firstName": "John",
  "lastName": "Doe",
  "createdAt": "2024-01-15T10:30:00Z",
  "updatedAt": "2024-01-15T10:30:00Z"
}

​
Resource collection

[
  {
    "id": "con_abc123",
    "email": "[email protected]",
    "firstName": "John",
    "lastName": "Doe"
  },
  {
    "id": "con_def456",
    "email": "[email protected]",
    "firstName": "Jane",
    "lastName": "Smith"
  }
]

​
Common headers

​
Request headers

HeaderRequiredDescription
AuthorizationYesBearer token or API key
FirstQuadrant-Organization-IDYes*Organization context (required for API keys)
Content-TypeYes**application/json for POST/PUT/PATCH requests
*Required when using API keys, optional for access tokens **Required when sending request body

​
Response headers

HeaderDescription
X-Request-IdUnique identifier for the request
VersionAPI version information
ETagEntity tag for caching

​
Next steps

Now that you’ve made your first API call, explore these topics:

​
API explorer

You can explore all available endpoints and test them interactively using our API documentation:

​
Support

If you have questions or need help with the API: