---
title: "Create submissions from emails"
method: POST
path: "/submissions/emails"
tags: ["Submissions"]
---

# Create submissions from emails

`POST /submissions/emails`

This API endpoint allows you to create submissions for a document template and send them to the specified email addresses. This is a simplified version of the POST /submissions API to be used with Zapier or other automation tools.

## Request body

- object
  - `template_id` integer, required — The unique identifier of the template.
  - `emails` string, required — A comma-separated list of email addresses to send the submission to.
  - `send_email` boolean — Set `false` to disable signature request emails sending.
  - `message` object — Custom signature request email message.
    - `subject` string — Custom signature request email subject.
    - `body` string — Custom signature request email body. Can include the following variables: {{template.name}}, {{submitter.link}}, {{account.name}}.

## Response `200`

OK

- object[]
  - `id` integer, required — Submitter unique ID number.
  - `submission_id` integer, required — Submission unique ID number.
  - `uuid` string, required — Submitter UUID.
  - `email` string, nullable, required — The email address of the submitter.
  - `slug` string, required — Unique key to be used in the form signing link and embedded form.
  - `status` 'completed' | 'declined' | 'opened' | 'sent' | 'awaiting', required — The status of signing request for the submitter.
  - `values` object[], required — An array of pre-filled values for the submitter.
    - `field` string, required — Document template field name.
    - `value` union, required — Pre-filled value of the field.
      - string
      - number
      - boolean
      - union[]
        - union
          - string
          - number
          - boolean
  - `metadata` object, required — Metadata object with additional submitter information.
  - `sent_at` string, nullable, required — The date and time when the signing request was sent to the submitter.
  - `opened_at` string, nullable, required — The date and time when the submitter opened the signing form.
  - `completed_at` string, nullable, required — The date and time when the submitter completed the signing form.
  - `declined_at` string, nullable, required — The date and time when the submitter declined the signing form.
  - `created_at` string, required — The date and time when the submitter was created.
  - `updated_at` string, required — The date and time when the submitter was last updated.
  - `name` string, nullable, required — The name of the submitter.
  - `phone` string, nullable, required — The phone number of the submitter.
  - `external_id` string, nullable, required — Your application-specific unique string key to identify this submitter within your app.
  - `preferences` object, required — Submitter preferences.
    - `send_email` boolean — Indicates whether the signature request email should be sent.
    - `send_sms` boolean — Indicates whether the signature request should be sent via SMS.
  - `role` string, required — The role of the submitter in the signing process.
  - `embed_src` string, required — The `src` URL value to embed the signing form or sign via a link.

---

[API](https://skmtc.dev/docusealco/apis/docuseal-api.md) · [All operations](https://skmtc.dev/docusealco/apis/docuseal-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/docusealco/docuseal-api/revisions/c209c00c2386/schema)