Add, update and unsubscribe MailGraf contacts, manage list membership and the block list, push custom events, and read campaigns and their reports.
Explore 15 workflow actions for MailGraf, including account permissions and operation limits.
8 read actions7 write actions
WORKFLOW ACTIONS
What you can configure.
Choose an action in the workflow builder, connect an account, and map its inputs. These actions are available in the catalog; your account access and a successful test determine whether they work for your setup.
Add a contact to a list
Write
Use this endpoint to add a contact to a list by email in one call.
Permissions and limits
Account permissions
A MailGraf API key (Settings, Developers, API keys; the plan must include API access)
A repeated request may repeat the external action. Review the previous result before retrying a write.
Add an email to the block list
Write
Use this endpoint to add an email address to the account block list.
Permissions and limits
Account permissions
A MailGraf API key (Settings, Developers, API keys; the plan must include API access)
A repeated request may repeat the external action. Review the previous result before retrying a write.
Campaign content
Read
Use this endpoint to read what a campaign says: subject, preview text, sender, the plain-text body and the links it contains.
Permissions and limits
Account permissions
A MailGraf API key (Settings, Developers, API keys; the plan must include API access)
Campaign report
Read
Use this endpoint to retrieve delivery and engagement totals for one campaign.
Permissions and limits
Account permissions
A MailGraf API key (Settings, Developers, API keys; the plan must include API access)
Create or update a contact
Write
Use this endpoint to create or update a contact by email address.
Permissions and limits
Account permissions
A MailGraf API key (Settings, Developers, API keys; the plan must include API access)
A repeated request may repeat the external action. Review the previous result before retrying a write.
Fetch a contact
Read
Use this endpoint to retrieve one contact by its MailGraf contact id.
Permissions and limits
Account permissions
A MailGraf API key (Settings, Developers, API keys; the plan must include API access)
Get the account for this API key
Read
Use this endpoint to confirm which MailGraf account the API key belongs to.
Permissions and limits
Account permissions
A MailGraf API key (Settings, Developers, API keys; the plan must include API access)
List campaigns
Read
Use this endpoint to list campaigns, ordered newest first.
Permissions and limits
Account permissions
A MailGraf API key (Settings, Developers, API keys; the plan must include API access)
List contacts
Read
Use this endpoint to retrieve contacts, ordered newest first.
Permissions and limits
Account permissions
A MailGraf API key (Settings, Developers, API keys; the plan must include API access)
List custom fields
Read
Use this endpoint to discover the account's custom fields before writing contacts.
Permissions and limits
Account permissions
A MailGraf API key (Settings, Developers, API keys; the plan must include API access)
List your lists
Read
Use this endpoint to discover the account's lists and their ids.
Permissions and limits
Account permissions
A MailGraf API key (Settings, Developers, API keys; the plan must include API access)
Push a custom event
Write
Use this endpoint to record a custom behaviour event for an existing contact.
Permissions and limits
Account permissions
A MailGraf API key (Settings, Developers, API keys; the plan must include API access)
A repeated request may repeat the external action. Review the previous result before retrying a write.
Remove a contact from a list
Write
Use this endpoint to remove a contact's membership from a list.
Permissions and limits
Account permissions
A MailGraf API key (Settings, Developers, API keys; the plan must include API access)
A repeated request may repeat the external action. Review the previous result before retrying a write.
Request a double opt-in confirmation
Write
Use this endpoint when the contact should confirm their subscription before being added.
Permissions and limits
Account permissions
A MailGraf API key (Settings, Developers, API keys; the plan must include API access)
A repeated request may repeat the external action. Review the previous result before retrying a write.
Unsubscribe a contact
Write
Use this endpoint to unsubscribe a contact, for example when they opt out in your CRM.
Permissions and limits
Account permissions
A MailGraf API key (Settings, Developers, API keys; the plan must include API access)
A repeated request may repeat the external action. Review the previous result before retrying a write.
SETUP
Start with a controlled test.
01Connect the intended account
Use the account and permissions required for your process. Review the connection check before configuring a workflow action.
02Review inputs and access
Select a listed operation and map its required inputs. Use test records and add a human approval before writes that need review.
03Confirm the result
Inspect step outputs and confirm the result in MailGraf. A saved workflow is not a completed provider action.