New API Endpoints: Contacts, Events & Webhooks
We’ve just shipped three new resource groups in the Emailit API v2. They are Contacts, Events, and Webhooks. Together they give you full programmatic control over your contact book, monitor events, and webhook integrations.
Contacts
The Contacts API lets you create, read, update, and delete contacts in your workspace. Each contact holds an email address, optional name and custom fields, and can be subscribed to one or more audiences in a single call.
| Endpoint | Description |
|---|---|
| List Contacts | Paginated list of all contacts |
| Get Contact | Retrieve a contact by ID or email |
| Create Contact | Create a new contact and subscribe to audiences |
| Update Contact | Update name, email, custom fields, or unsubscribe status |
| Delete Contact | Delete a contact and all associated subscribers |
Contacts can be looked up by their ID (con_xxx) or by email address, so you can use whichever identifier is most convenient.
{
"email": "john@example.com",
"first_name": "John",
"last_name": "Doe",
"custom_fields": { "company": "Acme" },
"audiences": ["aud_2BxFg7KNqr5M..."]
}
Events
Events are created automatically whenever something happens in your workspace. For example, an email is delivered, a contact is created, a domain is updated, and so on. The Events API gives you read-only access to this activity stream.
| Endpoint | Description |
|---|---|
| List Events | Paginated list with type filtering and optional data payload |
| Get Event | Retrieve a single event with full data |
You can filter by one or more event types using comma-separated values, and toggle include_data to control whether the full payload is returned in list responses.
GET /v2/events?type=email.accepted,email.delivered&include_data=true
Webhooks
Webhooks let you receive real-time HTTP callbacks whenever events occur. The new Webhooks API gives you complete control. You can create, update, enable/disable, and delete webhook endpoints, all through the API.
| Endpoint | Description |
|---|---|
| List Webhooks | Paginated list of all webhooks |
| Get Webhook | Retrieve a webhook by ID |
| Create Webhook | Create a new webhook endpoint |
| Update Webhook | Update URL, events, or enabled status |
| Delete Webhook | Delete a webhook by ID or name |
You can subscribe to specific event types or use all_events to receive everything.
{
"name": "Production Webhook",
"url": "https://example.com/webhook",
"events": ["email.accepted", "email.delivered", "email.bounced"]
}
There are over 30 event types available across emails, domains, audiences, subscribers, contacts, templates, suppressions, and email verifications. See the full list in the Create Webhook documentation.
Get started
All three APIs require a full-permission API key. Head over to the API Reference to explore all the new endpoints, or jump straight into the documentation linked above.
Blog
The latest news and updates, direct from Emailit.
Stay up to date with the latest articles from Emailit Blog.