Can I send campaigns through the API?

No. Use the API to manage contacts and lists, send events and read campaign reports. Create and send campaigns in the MailGraf app.

Can I use my own sign-up form?

Yes. Send a confirmation request through the API. MailGraf adds the person to your list after they confirm and can notify your system by webhook.

What happens if a webhook delivery fails?

MailGraf retries the delivery up to five times. You can see each response in the delivery log and retry it yourself if needed.

How can I investigate a failed connection?

Check the API request monitor for the key, response and request ID. For webhooks, open the delivery log to see your server's response.

Can I connect with Zapier or n8n without writing code?

Yes. Use the Integrations page to connect MailGraf to your store, CRM or forms through Zapier or n8n.

How do I protect my API keys?

Give each integration a separate key and keep it out of public code. If a key is exposed, revoke it in MailGraf and create a new one.

API and Webhooks

Connect MailGraf to your own systems

Keep contacts and lists in sync through the API, and use your own events to start automations. Signed webhooks send subscription, bounce and other updates back to your systems.

Start free trial Watch Demo

14-day free trial. No credit card required.

Request

POST https://api.mailgraf.com/v1/contacts
Authorization: Bearer mg_live_ab12…

{
  "email": "[email protected]",
  "first_name": "Emma",
  "country": "GB",
  "custom_fields": { "favourite_room": "Garden" }
}

A separate key for every connection

Give each integration its own API key. See when it was last used and revoke it whenever you need to.

Follow every webhook delivery

See which event was sent and how your server responded. Failed deliveries can be retried.

Turn events into automations

Send an event such as a paid order through the API to start the right flow for that contact.

How it works

Connect in three steps

Features

What can you build with the API and Webhooks?

Add and update contacts

Create or update a contact with one call. Custom fields are merged, not overwritten.

Manage lists and blocked addresses

Add people to lists, take them off again, unsubscribe them or block an address from your own system.

Bring reports into your dashboard

Read campaign results and content through the API, then show them in your own dashboard.

Start flows with your own events

Send an event such as order_paid to start an automation. Repeating the same event_id does not start it twice.

Stay informed about changes

Send sign-ups, unsubscribes, bounces and other changes back to your systems through webhooks.

Test before going live

Send a test event to your endpoint and see its response before real data flows.

Handle limits and errors

Know when to retry a rate-limited request and handle errors in one consistent format.

Connect without writing code

Use Zapier or n8n to connect MailGraf to your store, CRM or forms.

Explore integrations

Know what happened to every webhook

See the event, your server's response and each delivery attempt in one place. MailGraf retries failed deliveries, and you can retry them from the list too.

An HMAC-SHA256 signature on every delivery
Five attempts, then a clear failure you can retry
An endpoint that keeps failing is switched off and your team is told

Find the source of an API issue

See which key made a request, when it happened and what came back. Use the request ID to investigate a problem, or revoke a key if needed. Records stay available for 30 days.

Filter by key, response, method or date
A request ID on every response
Revoked keys stay in the list with their date

Collect confirmed sign-ups from your forms

Send a confirmation request from your own form through the API. Once the person confirms, MailGraf adds them to your list and notifies your system through a webhook.

The confirmation link stays valid for 7 days
The contact joins your list only after confirming
Your CRM hears about it straight away

“MailGraf just works. Five years in and we haven't experienced a single outage. When we need help, someone actually picks up. No ticket queues, no canned replies. For a mid-size team, that reliability is everything.”

DYWindow & Glass · Industrial8,500 contacts5+years, zero downtime