Confirmations

Which actions need a confirmation

• Send or schedule an email campaign
• Activate or deactivate an email automation
• Activate or deactivate an email of an automation
• Delete or archive
• Refund an order
• Stop a subscription or installment plan
• Deactivate an external customer

How it works

1. You call the endpoint, for example POST /v1/email/campaigns/{campaign_id}/send. Nothing happens yet.
2. The answer has a confirm_url and a confirmation_id.
3. The account owner opens the confirm_url while logged in to Tentary and clicks Confirm. Do not do it turns the action down.
4. With GET /v1/confirmations/{confirmation_id} you check the state.

The page in Tentary is called Confirm an AI action. It shows who asks, what will happen and a link to the object in Tentary.

States of a confirmation

status	Meaning
pending	Not decided yet.
running	Confirmed, the action runs now. Ask again in a few seconds.
done	The action ran. result has the details.
failed	The action could not run. result says why.
canceled	The action was turned down.
expired	The link expired.

Rules

• The link is valid for 5 minutes.
• Only the owner of the same account can confirm.
• An action runs once only.
• If the object changed after the request, for example the text of a campaign, Tentary does not run the action. Then send the request again.
• Each account can have at most 50 confirmation requests per day.

A confirmed action shows in the Activity log with the key or the app that asked.