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 from an audience. Only their own confirmation does that.

An added submission is returned as it is.

Your inbox,
on your own terms.

Email infrastructure for businesses, AI, agents and personal email. Built for scale, privacy and control. Everything email should have had from day one.

© 2026 OpenEmail. All rights reserved.