Attentive

Create a tracked short link for a message. A short link must exist before it can be referenced in body text: create it here, then pass it in the `shortLinkProperties` array of `update_sms_message` or `update_rcs_message`. Editing an existing short link is not supported — remove it and create a new one. Do not add global link tracking parameters to `redirectTargetUrl`; they are applied to the redirect targets at click time using the parameters stored on the message level.

create_short_link

Delete a campaign by ID.

delete_campaign

Remove a message from a message group. Use this to remove an A/B test variant. Removing one of the two variants of a draft A/B test or send time test turns it back into a one-time message group, as in Attentive UI, when the company has that enabled. For a send time test against Send Time AI, removing the Send Time AI variant keeps the specified send time, and removing the specified variant keeps Send Time AI. Otherwise, to go back to a single message, delete the message group and create a new one. Not available in recurring campaigns.

delete_campaign_message

Delete a message group from a campaign. Not available in recurring campaigns.

delete_campaign_message_group

Permanently delete an unpublished (draft) journey. This cannot be undone. Only journeys that have never been published can be deleted; published or live journeys must be archived instead.

delete_journey

Remove a node from the journey graph. Edits the journey's draft revision; call create_journey_draft first if it has none.

delete_journey_node

Delete a segment.

delete_segment

Generate AI-powered text suggestions for marketing messages. Provide a prompt describing the desired content, and receive multiple text options. Supports style adjustments like adding emojis, urgency, or making text shorter/funnier.

generate_copy

Get the company's AI brand voice settings: tone keywords, excluded words, emoji frequency, all-caps usage, urgency, product-title casing, and target message length (character/word/emoji/all-caps counts). Read these before drafting or planning email or SMS copy so generated content matches the brand voice.

get_brand_voice_settings

Get detailed campaign info by ID, including message groups and messages.

get_campaign

Get a campaign message group by ID, including its status, schedule, and A/B test variants.

get_campaign_message_group

Get SMS, email, or push campaign performance metrics for a company over a date range (defaults to the last 30 days). Returns query-wide aggregate values and one page of grouped rows, broken down by campaign, message group, or variant. SMS returns delivered, clicks, click rate, conversions, conversion rate, revenue, AOV, revenue per send, unsubscribes, unsubscribe rate, and fatigues. Email returns sends, delivered, unique and total opens and open rates, unique and total clicks and click rate, conversions, conversion rate, revenue, AOV, revenue per send, unsubscribes, unsubscribe rate, hard bounces, hard bounce rate, and spam reports. Push returns delivered, clicks, click rate, conversions, conversion rate, revenue, AOV, revenue per send, unsubscribes, and unsubscribe rate. These figures come from aggregated reporting data and may differ slightly from the realtime stats shown on campaign pages. To retrieve another page, pass pageInfo.endCursor as after, pass the previous response dateRange as startDate and endDate, and keep campaignName, campaignId, channel, and groupBy unchanged. Continue until pageInfo.hasNextPage is false. Optionally filter by campaign name or campaign ID.

get_campaign_metrics

Get detailed creative info by ID, including status, type, template config, display rules, and related resources.

get_creative

Get the company's email brand kit styles (buttons, headings, paragraphs, dividers, images, rows, spacers, titles, and template-wide defaults). Use `initialized=false` to detect a company that has never customized brand styles.

get_email_branding_styles

Get details of a specific email template by its GraphQL ID. Returns template name, subject, preview/content URLs, and optionally the full JSON content for editing.

get_email_template

Get detailed information for a single journey by ID, including name, state, trigger, tags, schedules, and category.

get_journey

Read how a branching node is currently configured: the dimension it tests, each branch's conditions with a readable label and node id, the steps under each branch, and the selection schemas for that dimension. Call this before update_journey_branch to edit a branch without dropping the others or the steps beneath them.

get_journey_branch

Read the configuration options available for a journey: which node types can be added/copied/moved (allowedSteps), and the valid branching dimensions for its trigger (each with its dimensionValue, branch count limits, and required selection schemaTypes). Call this before adding nodes or configuring branches to discover valid values for this specific journey/trigger instead of guessing.

get_journey_configuration

Get a summarized view of a journey's graph structure, including all steps (triggers, delays, messages, branches, experiments) with message text content. Filters out internal structural nodes for a clean readable flow. Returns the draft revision by default, whose node ids are the ones the journey write tools accept; revisionKind reports which revision was read.

get_journey_graph

Get the content of a journey message by its GraphQL message ID. Returns the message body text (SMS/RCS) or subject/preheader (email).

get_journey_message

Get a message by ID, including its content. Works for campaign and journey messages alike — for a campaign message the ID comes from get_campaign_message_group, for a journey message from get_journey_graph.

get_message

Read a journey revision's settings, including entry frequency (eligibilityDurationSeconds and eligibilityDurationUnits). Defaults to the draft revision if no revisionId is specified.

get_revision_settings

Get detailed segment info by ID.

get_segment

Get subscriber counts for a segment, broken down by channel with fatigue information.

get_segment_counts

Get the Attentive user and company information associated with the current session

get_user

List analytics metrics for this company from the metrics catalog. Returns each metric's ID (for query_metrics), name, description, data type, domain, and dimensions (including date granularities). Call before query_metrics. Optional metricIds: filter to specific metrics and receive commonDateGranularities — the date granularities valid for a single batch query_metrics call (intersection across all listed metrics; matches metrics-api validation).

list_metrics

List brand assets (images, folders) for a company.

list_brand_assets

List campaigns for a company with optional name, status, and recurring filters, and pagination.

list_campaigns

List creatives for a company with optional search, status filter, type filter, and pagination.

list_creatives

Returns the company's selected brand fonts in the exact shape the email brand kit form persists. Use a `fonts[].fontFamily` value verbatim as the `fontFamily` field of an EmailBrandingStylesInput module (button, paragraph, h1, h2, h3) or as `general.defaultFont`. Use a `fonts[].weights[].fontWeight` value verbatim as the `fontWeight` field of the same module. Empty `fonts` means the company has not configured brand fonts.

list_email_brand_kit_compatible_fonts

List email templates for the current company. Supports filtering by name and template type, with cursor-based pagination. Returns template names, subjects, preview URLs, and IDs for use with get_email_template.

list_email_templates

List available journey templates that can be used when creating a new journey. Templates provide pre-built journey flows for common use cases. Filter by language or channel (SMS, EMAIL, MULTI, PUSH).

list_journey_templates

List available journey triggers that can be used when creating a new journey with create_journey. Returns existing journey triggers, identified by their "id", as well as custom events that do not yet have a trigger, whose "id" is null and which are identified by their "customEventType" instead.

list_journey_triggers

List journeys for the company. Returns a paginated, summarized list of journeys (journeyId, name, description, state, triggerId, category, lastUpdated, tag display names). Supports filtering by status (LIVE, INACTIVE, DRAFT), trigger ID, and default flag. Use get_journey for full details on a specific journey.

list_journeys

List the real values available for a product attribute (product names, categories, tags, colors, brands, sizes, collections, options, sales channels). Use it to fill a DYNAMIC_MULTI_SELECT branch selection — product branching needs the company's actual values, which cannot be guessed. Supports search and paging.

list_product_attribute_values

List all subscribers in a segment. Returns up to 20 subscribers.

list_segment_subscribers

List segments for a company with filtering, search, and pagination.

list_segments

List the company's custom user attributes and their allowed values. Pass a searchTerm to find a specific attribute by name (recommended when there are many attributes). Use this to discover the IDs required to configure a SAVE_USER_ATTRIBUTE journey node or a CUSTOM_USER_PROPERTY_TYPE branch: each attribute returns `userAttributeId`, `userAttributeName`, the raw `propertyType`, and a `branchPropertyType` (the value to use in a branch selection), and each enumerated value returns `userAttributeValueId` and `userAttributeValueName`. For a branch, pass `userAttributeId` as the selection's userProperty.property and `branchPropertyType` as its propertyType. For a SAVE_USER_ATTRIBUTE node, pass the four userAttribute* fields to update_journey_node.

list_user_attributes

List companies which the current user belongs to with optional search filtering and pagination. Use this to find exact company IDs before company-scoped work.

list_user_companies

Move a node to a new position in the journey graph by specifying a new parent node. Edits the journey's draft revision; call create_journey_draft first if it has none.

move_journey_node