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: