customers_read
Arguments
Only decisions that used this shopper identifier, like
email:jane@example.com or phoneNumber:+15555550100.Only decisions at or after this instant.
Only decisions before this instant.
Only decisions with this outcome.
Only decisions with this reason.
Returns
A paginated list of MessageDecision items.
Show fields
Show fields
The list of edges (each a node plus its pagination
cursor).Show fields
Show fields
The item at this edge.
Show fields
Show fields
The marketing automation the decision belongs to, if any.
The campaign the decision belongs to, if any.
The channel of the message decided on. Null when the decision wasn’t about one channel.
The customer record Redo used. Null when Redo decided from a phone number or email alone.
When the campaign or automation had last been edited as of this decision, so you can tell which version decided. Null when unknown.
The shopper’s identifiers the decision used, like
email:jane@example.com or phoneNumber:+15555550100.The facts the decision used, like the quiet hours window. Their shape depends on the reason.
The nodes in this page, without the edge/cursor wrapper — a convenience over
edges.Show fields
Show fields
The marketing automation the decision belongs to, if any.
Show fields
Show fields
The automation’s legacy Mongo ObjectId (24-char hex) from before the CockroachDB migration.
When the current version was published. Null while it has only ever been a draft.
The nodes that make up this automation, including graph edges as step ids. A type this API version does not model field-by-field is returned as MarketingAutomationUnknownStep.
steps with every field selected, as JSON: one element per step, with __typename. Null and invalid stored steps are []. Webhook header values and OAuth client secrets are omitted. Edits go through operations.The campaign the decision belongs to, if any.
Show fields
Show fields
When the merchant canceled the campaign, if they did.
The email content this campaign sends, oldest arm first. A campaign that is not split-testing has exactly one entry; there is no separate
subject on the campaign because a split test has more than one.Why the campaign failed, when it did.
The segments held out of this campaign.Requires:
segments_readWhen the campaign failed to send, if it did.
Follow-up email configuration when one was enabled.
The from address recorded when the campaign sent. Null for drafts and for SMS campaigns.
The From mailbox chosen for this campaign. Null when the store default should be used, and for SMS.Requires:
campaigns_readThe campaign’s legacy Mongo ObjectId (24-char hex) from before the CockroachDB migration.
The reply-to address recorded when the campaign sent. Null when none was set.
The Reply-To mailbox chosen for this campaign. Null when the store default should be used.Requires:
campaigns_readWhen the campaign is scheduled to start sending. Null for drafts, and for campaigns scheduled in each recipient’s local time.
IANA time zone the merchant picked when scheduling a single UTC instant. Null for drafts and local-time sends.
IANA time zone used when a recipient has no time zone, for local-time sends. Null when
scheduledAt is set.For campaigns scheduled in each recipient’s local time, the wall-clock time they send at, as
YYYY-MM-DDTHH:mm:ss. Null when scheduledAt is set.The segments this campaign was sent to.Requires:
segments_readWhen the campaign finished sending. Null until it has finished.
Tags the merchant applied to this campaign, in the order they applied them. Free-form and merchant-defined — Redo attaches no meaning to them, so they are the place a store’s own categorisation (a promotion name, a season, a product line) is kept. Empty when the campaign is untagged.
The channel of the message decided on. Null when the decision wasn’t about one channel.
The customer record Redo used. Null when Redo decided from a phone number or email alone.
Show fields
Show fields
Merchant-defined custom field values, keyed by each field’s name. Null when the customer has no custom fields set.
The customer’s legacy identifier (the source Mongo ObjectId), accepted anywhere an
id is.The customer’s current location, if known.
The help desk tickets this customer is the primary contact on any thread of, newest first. Every ticket whose
customer is this customer is here.Requires: support_tickets_readShow fields
Show fields
Arguments
Forward pagination: returns the first N tickets (max 100, default 25). Use with
after; mutually exclusive with last/before.When the campaign or automation had last been edited as of this decision, so you can tell which version decided. Null when unknown.
The shopper’s identifiers the decision used, like
email:jane@example.com or phoneNumber:+15555550100.The facts the decision used, like the quiet hours window. Their shape depends on the reason.
Example
query {
messageDecisions(after: "...", before: "...", definitionId: "...", first: 10, identifier: "...", last: 10, occurredAfter: "...", occurredBefore: "...", outcome: ALLOWED, reason: AB_TEST_VARIANT) {
nodes {
automationRunId
automationStepId
channel
definitionKind
definitionUpdatedAt
id
identifiers
inputs
# ...
}
pageInfo { hasNextPage endCursor }
}
}