Update Prospect Email Copy

Changes one prospect's copy for one step, without re-importing. Send only the fields you are changing: a field left out keeps the copy already stored. The email is rebuilt from the new copy straight away, and the response carries the rebuilt email, so there is no need to call Rebuild Step Emails.

Write the copy as subjectText and bodyText, the same shorthand Import Contacts takes. A token naming no known field is rejected. On a PER_CONTACT step the result must still be able to send: a body, plus a subject on the first email. A follow-up with no subject is sent as a reply in the first email's thread.

An email that has already been sent, or is sending, cannot be changed, and the call is rejected with a 400.

Re-importing the prospect with emails also updates its copy, and is the better route for many prospects at once.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

Get this from Settings > Workspaces. Starts with "account_".

string
required

Get this from Settings > Workspaces > Workspace ID column. On read endpoints you may also pass the literal value all to span every workspace in the account.

string
required

The prospect (ICP membership) id.

integer
required
0 to 3

Position in the sequence, zero-based. 0 is the first email.

Body Params
string
length ≤ 500

Subject as shorthand, on a single line. Blank on a follow-up sends it as a reply in the first email's thread.

string
length ≤ 20000

Body as shorthand. A new line starts a new paragraph.

Responses

400

The copy has an unknown token or would leave a PER_CONTACT step unable to send, or the email has already been sent.

404

No such prospect in your account

Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json