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

The Vetta 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 Vetta

Core Concepts

Resources

Every object in Vetta (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"
  }
}

SDKs

Official SDKs are available for:

Language	Package	Install
JavaScript / TypeScript	`@vetta/sdk`	`npm install @vetta/sdk`
Python	`vetta`	`pip install vetta`
Go	`github.com/vetta-ai/go-sdk`	`go get github.com/vetta-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 Vetta API