Forms API

The forms surface is read-only in `v1` and is intended for operational visibility, dashboards, or admin tooling that needs to inspect capture points.

2 min read

Read forms

The forms surface is read-only in v1. Use it when you need to inventory Mailrith-managed capture points or inspect form metadata from an external dashboard.

Endpoint

List forms to retrieve their definitions, styling payloads, and recent subscriber volume.

GET /v1/forms

List forms

Returns forms in the authenticated workspace.

View schema

POST /v1/forms

Create a form

Creates a form in the authenticated workspace.

View schema

GET /v1/forms/{form_id}

Get a form

Returns a form in the authenticated workspace.

View schema

PUT /v1/forms/{form_id}

Update a form

Updates an existing form in place.

View schema

DELETE /v1/forms/{form_id}

Delete a form

Deletes a form from the authenticated workspace.

View schema

List forms

curl "https://api.mailrith.com/v1/forms?limit=25" \
  -H "Authorization: Bearer mrk_example_secret_key"

Need help shipping an integration?

Reach the Mailrith team if you need help planning a sync, validating a webhook flow, or troubleshooting a request.

Contact Mailrith

Related guides

2 min read

Custom Fields API

Read the typed custom-field schema available to the authenticated workspace.

4 min read

Subscribers API

List and upsert subscribers with tags, sequences, and custom-field values.

6 min read

API Reference

Browse the generated endpoint reference and download the OpenAPI contract.

Custom Fields API

Segments API