Skip to main content
This guide walks you through making your first API request to retrieve data from a linked account.

​
Prerequisites

  1. API Key created in StackOne Dashboard and copied to a secure location
  2. Basic Authentication Setup - Learn how to properly authenticate with StackOne API using your API key
  3. Required provider integration enabled
  4. Account linked successfully
  5. (Optional) Use an SDK or Postman

​
Getting Account ID

Authentication: When using curl -u "$API_KEY:", encoding is handled automatically. When setting the Authorization header manually, you must base64 encode your API key first. See the Basic Authentication Guide for details.
  1. List your linked accounts to find the account ID:
curl --request GET \
     --url https://api.stackone.com/accounts \
     --header 'accept: application/json' \
     --header 'authorization: Basic {base64_encoded_api_key}'
  1. From the response, copy the id value for your desired provider account.
Filter by provider using the providers query parameter:
curl --request GET \
     --url 'https://api.stackone.com/accounts?providers={provider_name}' \
     --header 'accept: application/json' \
     --header 'authorization: Basic {base64_encoded_api_key}'

​
Making Your First Request

Now you’re ready to make your first CRM API call. Let’s list contacts from the connected CRM system: 
curl --request GET \
  --url 'https://api.stackone.com/unified/crm/contacts' \
  --header 'accept: application/json' \
  --header 'authorization: Basic {base64_encoded_api_key}' \
  --header 'x-account-id: {account_id}'

​
Example Response

{
  "data": [
    {
      "id": "contact_123",
      "remote_id": "abc123",
      "first_name": "Sarah",
      "last_name": "Mitchell",
      "emails": [
        {
          "type": "work",
          "value": "[email protected]"
        }
      ],
      "phone_numbers": [
        {
          "type": "work",
          "value": "+1-555-0456"
        }
      ],
      "company_name": "Acme Corp",
      "created_at": "2024-01-10T08:00:00Z"
    }
  ]
}

​
Next Steps

Get Contact

Retrieve details for a specific contact

List Accounts

Get company accounts from the CRM

Pagination

Handle large result sets efficiently

Get All Lists

View contact lists and segments

​
References