add_contact_to_list
ChatGPTAdds one person to a list, creating the contact if needed. A list that asks for confirmation sends them a confirmation email first; they join once they confirm. Only add people who have agreed to hear from the account.
create_campaign_draft
ChatGPTSaves a new campaign as a draft in EmailFig and returns a link to it. It never sends: a person reviews the draft and sends it from EmailFig. Call get_email_format before writing blocks.
get_account
ChatGPTThe account's name, plan, contact count, sending domain and whether it can send email yet.
get_automation_report
ChatGPTOne automation's results: how many people entered, are in it, finished or left early and why, each step with who is waiting there and each email's results, and opens and clicks over the last 7 or 30 days.
get_campaign
ChatGPTOne campaign's email and setup: subject, preview text, sender, who it goes to, and its content (a drag and drop design that create_campaign_draft takes as body.blocks, or HTML as body.html). For a draft it also says whether this chat app can still revise it and what it still needs; when still_needed is null the draft is ready, and the person sends or schedules it from review_link. Rates and top links are in get_campaign_report.
get_campaign_report
ChatGPTOne campaign's results: sent, delivered, opens, clicks and unsubscribes with rates, and its top links.
get_contact
ChatGPTOne contact with its status, lists, tags and custom fields. Give the contact's id or its email address.
get_contact_activity
ChatGPTWhat has happened to one contact: recent email events (last 90 days, newest first, up to 50), the automations they have been in, and whether a suppression blocks mail to them.
get_email_format
ChatGPTHow to write the body of create_campaign_draft: the editor's block format, the rules a draft must follow, the default settings and a short example. Read it before writing blocks.
get_template
ChatGPTOne template's content. A drag and drop template returns its design (blocks and settings), which create_campaign_draft takes as body.blocks; any other template returns its HTML.
list_automations
ChatGPTThe account's automations, newest first, with what starts each one, how many people are in it now, how many are stuck, and how many email steps it has.
list_campaigns
ChatGPTRecent campaigns, newest first, with status and headline stats. Returns up to 25.
list_custom_fields
ChatGPTThe account's custom contact fields and the choices for dropdown fields.
list_forms
ChatGPTThe account's signup forms with their last 30 days of views, signups and confirmations. Views are directional: some bots load forms and are counted.
list_images
ChatGPTThe account's image library, newest first. Use an image's url as an image block's src. Returns up to 25.
list_lists
ChatGPTThe account's lists with subscriber counts and whether signup needs email confirmation.
list_segments
ChatGPTThe account's saved segments, for choosing a campaign audience.
list_tags
ChatGPTThe account's tags with how many subscribed contacts carry each.
list_templates
ChatGPTThe account's saved email templates, most recently edited first.
render_email_preview
ChatGPTRenders a drag and drop campaign's MJML as preview HTML for the email preview view.
search_contacts
ChatGPTFinds contacts whose email address or name contains the search text (at least 3 characters). Returns up to 25.
send_test_email
ChatGPTEmails a test of a draft campaign to the connected person's own address, with sample values for merge tags. It goes only to that address and only for a draft; it never sends the campaign.
tag_contact
ChatGPTPuts a tag on a contact, creating the tag if it doesn't exist.
unsubscribe_contact
ChatGPTRecords that someone has opted out, so no list or campaign emails them. Give the contact's id or the email address. They can only come back by signing up again and confirming by email.
untag_contact
ChatGPTTakes a tag off a contact. The tag itself stays.
update_campaign_draft
ChatGPTChanges a draft this chat app created, until someone saves it in EmailFig. Only the fields given change, and they mean what they mean in create_campaign_draft. It never sends.
update_contact
ChatGPTChanges a contact's name or custom field values. Only what you send changes; custom fields you leave out keep their values.
upload_image_from_url
ChatGPTAdds an image from a public https address to the account's image library and returns it. PNG, JPEG or GIF, under 10 MB. Use its url as an image block's src.