forms

List forms

Returns the forms your key can access, newest first, each with its full configuration.

get/v1/forms

Request

  • Base URL: https://api.formcarry.com
  • URL: https://api.formcarry.com/v1/forms
  • Auth: HTTP bearer

Query parameters

limitnumber

Results per page.

cursorstring

The next_cursor value from the previous page.

team_idstring

Only this team (must be one the credential covers). Useful for connections that span several teams.

Response

has_moreboolean required
next_cursorstring nullable required

Example response

{
  "data": [
    {
      "id": "AbC123xyz",
      "name": "Contact form",
      "endpoint": "https://formcarry.com/s/AbC123xyz",
      "avatar": "🚀",
      "created_at": "2026-01-15T10:00:00.000Z",
      "self_email_notification": {
        "recipients": [
          "me@company.com"
        ],
        "logo_url": "https://example.com/logo.png"
      },
      "auto_response": {
        "logo_url": "https://example.com/logo.png"
      },
      "after_submit": {
        "page": {
          "headline": "Thank you!",
          "message": "We have received your submission",
          "logo_url": "https://example.com/thanks",
          "logo_dark_url": "https://example.com/thanks",
          "primary_color": "#0f766e",
          "secondary_color": "#f0fdfa",
          "return_button": {
            "url": "https://example.com/thanks"
          },
          "download_button": {
            "url": "https://example.com/thanks"
          }
        },
        "redirect": {
          "success_url": "https://example.com/thanks",
          "fail_url": "https://example.com/thanks"
        }
      },
      "webhooks": [
        {
          "id": "whk_3f9Kq2bLm8xZpQ1rT7vWc0",
          "url": "https://example.com/hooks/formcarry",
          "description": "CRM sync",
          "events": [
            "submission.created"
          ],
          "signing": {
            "algorithm": "hmac-sha256",
            "header": "X-Formcarry-Signature"
          },
          "last_delivery": {
            "at": "2026-09-13T12:00:00.000Z",
            "response_status": 200,
            "attempt": 1
          },
          "created_at": "2026-09-13T12:00:00.000Z"
        }
      ],
      "validation": {
        "rules": [
          {
            "field": "email"
          }
        ]
      }
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.