sendsend.email
Sign inStart building

List signup forms

GET/v1/forms

All forms in the project, or those of one audience.

Required scope: contacts:manage

Parameters

NameInDescription
audience_idoptionalqueryOnly forms of this audience.

Example

curl -X GET 'https://api.sendsend.email/v1/forms' \
  -H "Authorization: Bearer $SENDSEND_API_KEY"

Response 200

{
  "object": "list",
  "data": [
    {
      "id": "frm_Bn6…",
      "object": "form",
      "audience_id": "aud_7Qe2…",
      "name": "Footer signup",
      "title": "Join the newsletter",
      "double_opt_in": true,
      "from": "Acme <news@mail.acme.com>",
      "confirm_subject": null,
      "success_url": null,
      "confirmed_url": "https://acme.com/welcome",
      "topic_ids": [],
      "collect_name": false,
      "active": true,
      "url": "https://api.sendsend.email/f/frm_Bn6…",
      "created_at": "2026-10-06T15:00:00.000Z",
      "updated_at": "2026-10-06T15:00:00.000Z"
    }
  ]
}

Errors

StatusCodeWhen
401unauthorizedThe API key is missing, invalid or revoked.
403forbiddenThe key does not have the scope this endpoint needs.

Every error has the same shape. See Errors.