Skip to content
One platform. From customer conversation to completed work.Take a closer look
All connections
Marketing · CONNECTION

MailGraf + NodeHub

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.

Follow the workflow quickstart
EXPLORE YOUR STACK

More in Marketing.

MailGraf integration | NodeHub