The Dalil AI REST API gives you programmatic access to contacts, deals, sequences, and AI capabilities. Build automations, sync data, and extend Dalil to fit your workflow.

The Dalil AI API is a RESTful API that uses standard HTTP methods, JSON request and response bodies, and Bearer token authentication.

Base URL

All API requests should be made to:

https://api.usedalil.ai/v1

What You Can Build

The API gives you full access to:

Contacts: Create, read, update, delete, and enrich contacts
Deals: Manage your pipeline programmatically
Sequences: Start, pause, and monitor email sequences
Analytics: Pull performance data into your own dashboards
AI enrichment: Trigger enrichment jobs on demand
Webhooks: Receive real-time events when things happen in Dalil

Core Concepts

Resources

Every object in Dalil (a contact, deal, sequence) is a resource with a unique ID.

{
  "id": "cnt_01HXY8Z9A0B1C2D3E4F5G6H7J",
  "type": "contact",
  "email": "sarah@acmecorp.com",
  "first_name": "Sarah",
  "last_name": "Chen",
  "company": "Acme Corp",
  "created_at": "2026-04-15T10:30:00Z"
}

IDs are prefixed by resource type: cnt_ for contacts, deal_ for deals, seq_ for sequences.

Pagination

List endpoints return paginated results:

{
  "data": [...],
  "meta": {
    "total": 1247,
    "page": 1,
    "per_page": 50,
    "next_cursor": "eyJpZCI6ImNudF8wMUhYWThaOUEwQjF..."
  }
}

Use cursor-based pagination for large datasets. Pass cursor=... as a query parameter to get the next page.

Errors

All errors follow a consistent format:

{
  "error": {
    "code": "contact_not_found",
    "message": "No contact found with ID cnt_01HXY8Z9A0B1C2D3E4F5G6H7J",
    "status": 404,
    "request_id": "req_7f8g9h0i"
  }
}

See Errors & Status Codes for the full list.

SDKs

Official SDKs are available for:

Language	Package	Install
JavaScript / TypeScript	`@dalilai/sdk`	`npm install @dalilai/sdk`
Python	`dalilai`	`pip install dalilai`
Go	`github.com/dalil-ai/go-sdk`	`go get github.com/dalil-ai/go-sdk`

Getting Your API Key

Log in to app.usedalil.ai
Go to Settings → API Keys
Click Create new API key
Name your key and set permission scopes
Copy the key — it's only shown once

⚠️

Store your API key securely. Never commit it to source control. Use environment variables in your application.

Next Steps

Authentication — Learn how to authenticate your requests
Contacts API — Start working with your contacts
Webhooks — Set up real-time event notifications

Introduction to the Dalil AI API