Forms

Add subscriber to form by email address

The subscriber being added to the form must already exist. Subscribers can be created using the "Create a subscriber" endpoint.

Note: Archived, deleted and restricted forms no longer accept subscribers. Adding a subscriber to one returns a 422 and creates no subscription. The error message names the form's status, so check for the 422 rather than matching the text.

post/v4/forms/{form_id}/subscribers

Request

  • Base URL
    https://api.kit.com
  • URL
    https://api.kit.com/v4/forms/{form_id}/subscribers
  • Auth
    • API key in header X-Kit-Api-Key
    • or OAuth 2
      Authorization code: https://api.kit.com/v4/oauth/authorize
      Token URL: https://api.kit.com/v4/oauth/token

Path parameters

form_idinteger required

Request body

email_addressstring required
referrerstring nullable

Response

Returns a 200 when the subscriber has already been added to the form

Changes

No recorded changes to this operation across all 2 revisions of this API.