Skip to the documentation
API

Approve a submission

Adds the person of a pending sign-up to its audiences without waiting for them to confirm, for when you know them.

POST/forms/{id}/submissions/{submissionId}/approve

Runs the real call on your workspace.

POST /forms/{id}/submissions/{submissionId}/approve

Adds the person of a pending sign-up to its audiences without waiting for them to confirm, for when you know them.

Example

Needs forms:write and contacts:write. No body.

curl
curl -X POST "$OE/forms/frm_3b9d2e7a1c4f80d56e2a9b14/submissions/fsb_8e2c4a6b1d3f57e09a2c4e6b/approve" -H "$AUTH"
Response
{  "object": "form_submission",  "id": "fsb_8e2c4a6b1d3f57e09a2c4e6b",  "formId": "frm_3b9d2e7a1c4f80d56e2a9b14",  "email": "[email protected]",  "status": "added",  "expired": false,  "answers": [    {      "fieldId": "fld_k2m8q4w9z1x7",      "key": "email",      "label": "Email",      "type": "email",      "value": "[email protected]",      "display": "[email protected]"    },    {      "fieldId": "fld_p7r3t5v2y8n4",      "key": "first_name",      "label": "First name",      "type": "text",      "value": "Ann",      "display": "Ann"    }  ],  "audienceIds": ["aud_4c1b8e2a7d9f05c36b4e8a71"],  "sourceUrl": "https://acme.com/blog",  "confirmedAt": "2026-09-30T16:44:02.000Z",  "createdAt": "2026-09-30T16:42:11.000Z"}

Approving does not subscribe again someone who unsubscribed. Only their own confirmation does that.

An added submission is returned as it is.

Reference