Onboard a guest and send a welcome message

Onboard a guest and send a welcome message

Create a guest contact, subscribe them to a list, send a welcome email and confirm delivery.

1. Confirm the account has credit before doing anything that spends it. Deliveries and email validation draw this balance down; there is no documented behaviour at zero.
2. Look the guest up by your own user_id before creating them. There is no idempotency on createContact, so this check is the only thing standing between a retry and a duplicate guest record.
3. Create the guest with consent recorded in the same call. Returns 201 with the contact id — a 24-character hex string that is the handle for every downstream step.
4. Find the audience list to subscribe the new guest to.
5. CONSEQUENTIAL STEP — this reaches a real person and spends real credit, and it is not idempotent. Gate it behind confirmation in any autonomous loop.
6. Follow the message to a terminal status. Match on "deliverd" — the misspelling is in the provider's own published status vocabulary. "undefined" is also a real value in that enum.

What you'll need to have ready

• accountId: The Cendyn CRM account id. Not derivable from the token — it must be supplied.
• userId: Your own backend identifier for this guest. The documented de-duplication key.
• email: Guest email. Either email or phone_countrycode plus phone_number is required.
• firstName
• lastName
• language: ISO-2 language code, e.g. ES.
• gdprMarketingConsent
• gdprDate: ISO 8601 timestamp of when consent was given.
• gdprRemoteIp: The IP address the guest consented from.
• welcomeSubject

For your developer

Arazzo workflow push:onboardAndWelcomeGuest, 6 operations: currentBalanceAccount → listContact → createContact → listAudienceList → sendEmailDeliveries → listDeliveries. Specs on APIs.io.