API Reference Overview

Base URL

All API requests use the following base URL:

https://api.morphic.io/api

Request format

All request bodies must be JSON with Content-Type: application/json
File uploads use Content-Type: multipart/form-data
UUIDs are used for all resource identifiers

Authentication

Include your API key in every request:

curl -H "X-API-Key: sk_your_api_key_here"

headers = {"X-API-Key": "sk_your_api_key_here"}

const headers = { "X-API-Key": "sk_your_api_key_here" };

Response format

All responses return JSON. Successful responses return the resource directly or a paginated wrapper:

// Single resource
{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "full_name": "Jane Smith",
  "created_at": "2026-01-15T10:30:00Z",
  "updated_at": "2026-02-20T14:00:00Z"
}

// Paginated list
{
  "items": [],
  "total": 42,
  "page": 1,
  "page_size": 25,
  "total_pages": 2
}

Common patterns

Pattern	Example
List resources	`GET /api/contacts?page=1&page_size=25`
Get by ID	`GET /api/contacts/{id}`
Create	`POST /api/contacts`
Update	`PUT /api/contacts/{id}`
Delete	`DELETE /api/contacts/{id}`
Bulk delete	`POST /api/contacts/bulk-delete`

Endpoint groups

Group	Prefix	Description
Contacts	`/api/contacts`	People in your CRM
Companies	`/api/companies`	Organizations and teams
Deals	`/api/deals`	Sales pipeline deals
Activities	`/api/activities`	Calls, meetings, tasks
Notes	`/api/notes`	Notes on entities
Favorites	`/api/favorites`	Bookmarked records
Email Drafts	`/api/email-drafts`	Email drafts
Email Templates	`/api/email-templates`	Email templates
Knowledge Base	`/api/kb`	KB documents
Chats	`/api/chats`	AI chat conversations

List contacts

​Base URL

​Request format

​Authentication

​Response format

​Common patterns

​Endpoint groups

Base URL

Request format

Authentication

Response format

Common patterns

Endpoint groups