Salesly Developer API

This guide walks you through making your first API call to Salesly.

Prerequisites

A Salesly account with an active subscription
Your API key (found in Settings → Integrations)

Step 1: Get Your API Key

Log in to Salesly CRM
Navigate to Settings → Integrations
Copy your API Key

Keep your API key secret. Do not share it in client-side code, public repositories, or URLs.

Step 2: Make Your First Request

Let's fetch the list of contact types available in your account.

curl -X GET "https://rest.salesly.app/api/v1/developers/contacts/types" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Accept: application/json"

Expected response:

200 OK

{
  "data": [
    { "id": 1, "ref": "client", "value": "Client" },
    { "id": 2, "ref": "lead", "value": "Lead" }
  ]
}

Step 3: Create a Contact

curl -X POST "https://rest.salesly.app/api/v1/developers/contacts" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "name": "ACME Corporation",
    "type": "client",
    "email": "[email protected]",
    "phone": "+34 600 000 000"
  }'

200 OK

{
  "data": {
    "id": 1,
    "name": "ACME Corporation",
    "email": "[email protected]",
    "phone": "+34 600 000 000",
    "type": 1,
    "created_at": "2026-03-05T10:30:00+00:00",
    "updated_at": "2026-03-05T10:30:00+00:00"
  }
}

Step 4: List Your Contacts

curl -X GET "https://rest.salesly.app/api/v1/developers/contacts?per_page=10&page=1" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Accept: application/json"

See Pagination for details on navigating large result sets.

Next Steps

Authentication — learn about API key security
Error Handling — understand error responses
Contacts API Reference — full contact API reference

Getting Started