Triggered email fails "issue with recipients" — Velo custom trigger completes with Contact Id, but recipient won't resolve

Ask the community
, , ,
1

Title: Triggered email fails “issue with recipients” — Velo custom trigger completes with Contact Id, but recipient won’t resolve

Body:

Classic Editor + Velo. A scheduled job fires a Velo code custom trigger wired to a “Send triggered email” action.

In the Run Log:

  • Velo code trigger → Completed. Trigger data shows all payload fields (Email, Country, First Name, Health Check Date, Contact Id) plus the full Contact details tree.
  • Send email → “Failed due to issue with recipients, e.g. unsubscribed or banned.”

Ruled out: sender verified, transactional=true, contact deliverability VALID (not unsubscribed/banned), sendToUnsubscribed=true.

I defined the payload schema (contactId: uuid), clicked Mark Contact ID + Save Structure, and set the email recipient to the trigger’s Contact Id. But validation still reports:

MAPPING_VARIABLE_MISSING_FROM_SCHEMA (fieldKey: "contactId")

— even though the trigger clearly receives contactId at runtime. Same warning appears for the email variable too.

So the trigger gets the data fine, but the email action behaves as if contactId isn’t declared in the trigger schema, and the recipient never resolves.

Questions:

  1. Correct way to make a custom-trigger contactId resolve as the email recipient — is “Mark Contact ID” enough?
  2. Known issue where the trigger UI’s payload schema / Contact ID mark doesn’t sync to what the email action validates against?
  3. Is MAPPING_VARIABLE_MISSING_FROM_SCHEMA blocking, or just a warning?

Environment: @wix/automations + @wix/essentials, customTrigger.runTrigger from a backend scheduled job.

2

If I understand correctly, it should be

I’m not sure I follow - have you got any screenshots?

I think it would help if you could share the code that you’re using. It’s difficult to assist in debugging without seeing what you currently have and where the errors might be.