formcarry-com api reference API

openapi: 3.1.0
info:
  title: formcarry-com api reference API
  version: '2026-10-30'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-10-30: 5 operation(s) read from 5 public documentation page(s) (each operation
    names its page in x-source). This is not the provider''s published contract; formcarry-com has published no machine-readable contract that
    the pipeline could find. Engine: local.'
  x-evidence-tiers:
    code-example: 22
    documentation: -11
    pages-with-code: 22
    pages-read: 22
  x-generated-from: documentation
  x-provenance: generated
  x-authored-by: API Evangelist
  x-generated: '2026-10-30'
  x-generator: generate-contract-from-docs.py
  x-engine: local
  x-sources:
  - https://formcarry.com/docs/api-reference/forms/add-a-recipient
  - https://formcarry.com/docs/api-reference/forms/create-a-form
  - https://formcarry.com/docs/api-reference/forms/list-email-servers
  - https://formcarry.com/docs/api-reference/forms/remove-a-recipient
  - https://formcarry.com/docs/api-reference/forms/upload-an-image
  x-docs-section: api-reference
servers:
- url: https://api.formcarry.com
paths:
  /v1/email-servers:
    get:
      operationId: get_v1_email_servers
      tags:
      - Email Servers
      summary: GET /v1/email-servers
      x-source: https://formcarry.com/docs/api-reference/forms/list-email-servers
      responses:
        '200':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetV1EmailServersResponse'
      x-evidence:
        kind: code-example
        language: curl
        snippet: 'curl curl --request GET  --url https://api.formcarry.com/v1/email-servers  --header ''Authorization: Bearer <token>'' import
          requests

          url = "https://api.formcarry.com/v1/email-servers"

          headers = {"Authorization": "Bearer <token>"}

          response = requests.get(url, headers=headers)

          print(response.text) const options = {method: ''GET'', headers: {Authorization: ''Bearer <token>''}};

          fetch(''https://api.formcarr'
  /v1/forms:
    post:
      operationId: post_v1_forms
      tags:
      - Forms
      summary: POST /v1/forms
      x-source: https://formcarry.com/docs/api-reference/forms/create-a-form
      responses:
        '201':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostV1FormsResponse'
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl curl --request POST  --url https://api.formcarry.com/v1/forms  --header 'Authorization: Bearer <token>'  --header 'Content-Type:\
          \ application/json'  --data ' \n { \n \"name\": \"Contact form\", \n \"active\": true, \n \"folder_id\": \"<string>\", \n \"storage\"\
          : { \n \"store_submissions\": true \n }, \n \"spam\": { \n \"protection\": true, \n \"captcha\": { \n \"secret_key\": \"<string>\" \n\
          \ } \n }, \n \"self_email_notification\": {"
  /v1/forms/{formid}/images:
    get:
      operationId: get_v1_forms_formid_images
      tags:
      - Forms
      summary: GET /v1/forms/{formId}/images
      x-source: https://formcarry.com/docs/api-reference/forms/upload-an-image
      parameters:
      - name: formid
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetV1FormsFormidImagesResponse'
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl);\nif ($err) {\n echo \"cURL Error #:\" . $err;\n} else {\n echo $response;\n} package main\nimport (\n \"fmt\"\n \"strings\"\
          \n \"net/http\"\n \"io\"\n)\nfunc main() {\n url := \"https://api.formcarry.com/v1/forms/{form_id}/images\"\n payload := strings.NewReader(\"\
          -----011000010111000001101001\\r\\nContent-Disposition: form-data; name=\\\"file\\\"; filename=\\\"example-file\\\"\\r\\nContent-Type:\
          \ application/octet-stream\\r\\n\\r\\n<"
  /v1/forms/{formid}/self-email-notification/recipients:
    get:
      operationId: get_v1_forms_formid_self_email_notification_recipients
      tags:
      - Forms
      summary: GET /v1/forms/{formId}/self-email-notification/recipients
      x-source: https://formcarry.com/docs/api-reference/forms/add-a-recipient
      parameters:
      - name: formid
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetV1FormsFormidSelfEmailNotificationRecipientsResponse'
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl);\nif ($err) {\n echo \"cURL Error #:\" . $err;\n} else {\n echo $response;\n} package main\nimport (\n \"fmt\"\n \"strings\"\
          \n \"net/http\"\n \"io\"\n)\nfunc main() {\n url := \"https://api.formcarry.com/v1/forms/{form_id}/self-email-notification/recipients\"\
          \n payload := strings.NewReader(\"{\\n \\\"email\\\": \\\"me@company.com\\\"\\n}\")\n req, _ := http.NewRequest(\"POST\", url, payload)\n\
          \ req.Header.Add(\"Authorization\", \"Bearer"
  /v1/forms/{formid}/self-email-notification/recipients/{email}:
    get:
      operationId: get_v1_forms_formid_self_email_notification_recipients_email
      tags:
      - Forms
      summary: GET /v1/forms/{formId}/self-email-notification/recipients/{email}
      x-source: https://formcarry.com/docs/api-reference/forms/remove-a-recipient
      parameters:
      - name: formid
        in: path
        required: true
        schema:
          type: string
      - name: email
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetV1FormsFormidSelfEmailNotificationRecipientsEmailResponse'
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl);\nif ($err) {\n echo \"cURL Error #:\" . $err;\n} else {\n echo $response;\n} package main\nimport (\n \"fmt\"\n \"net/http\"\
          \n \"io\"\n)\nfunc main() {\n url := \"https://api.formcarry.com/v1/forms/{form_id}/self-email-notification/recipients/{email}\"\n req,\
          \ _ := http.NewRequest(\"DELETE\", url, nil)\n req.Header.Add(\"Authorization\", \"Bearer <token>\")\n res, _ := http.DefaultClient.Do(req)\n\
          \ defer res.Body.Close()\n b"
security:
- bearer: []
components:
  schemas:
    GetV1EmailServersResponse:
      type: object
      properties:
        method:
          type: string
        headers:
          type: object
          properties:
            Authorization:
              type: string
    PostV1FormsResponse:
      type: object
      properties:
        enabled:
          type: boolean
        subject:
          type: string
        from_name:
          type: string
        logo_url:
          type: string
        logo_height:
          type: integer
        template:
          type: object
          properties:
            message:
              type: string
            html:
              type: string
    GetV1FormsFormidImagesResponse:
      type: object
      properties:
        url:
          type: string
    GetV1FormsFormidSelfEmailNotificationRecipientsResponse:
      type: object
      properties:
        recipients:
          type: array
          items:
            type: string
    GetV1FormsFormidSelfEmailNotificationRecipientsEmailResponse:
      type: object
      properties:
        recipients:
          type: array
          items:
            type: string
  securitySchemes:
    bearer:
      type: http
      scheme: bearer
tags:
- name: Email Servers
- name: Forms