API introduction

The MailGraf REST API lets your own systems exchange data with a MailGraf account. Use it when a CRM, commerce platform, form or workflow needs to add contacts, manage list membership or read campaign results without a manual export.

What you can do

The current public API supports these tasks:

• create or update a contact using their email address
• retrieve contacts and discover lists
• add or remove a contact from a list
• add an email address to the account block list
• send custom behaviour events that can start automations
• read campaigns and their delivery reports

Campaign creation, campaign sending and account administration remain in the MailGraf app.

How access works

1. Create an API key

   Open Settings > API keys and click Create API key. The full key is shown once, so copy it to a secret manager or secure server configuration.

2. Authenticate each request

   Send the key in the Authorization header as a bearer token. Read Authentication before connecting a production service.

3. Call the public API

   Send requests to https://api.mailgraf.com/v1. Start with the read-only account check in Send your first request.

Use the right documentation

Help Center articles explain tasks and integration choices in plain language. The API reference is the contract for endpoint paths, request fields, response schemas and error codes. If the two appear to differ, follow the API reference and report the Help Center article so it can be corrected.

Where the full reference lives

Open the API reference to explore every available endpoint and its current contract.