---
title: "Send scheduled invite"
method: POST
path: "/document/{document_id}/scheduled-invite/send"
---

# Send scheduled invite

`POST /document/{document_id}/scheduled-invite/send`

## Request

- Base URL: `https://api.signnow.com`
- URL: `https://api.signnow.com/document/{document_id}/scheduled-invite/send`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/signnow/apis/signnow-api/docs/document/:document_id/scheduled-invite/send/post.ts> (a function with typed inputs; its response is checked against the schema)

This endpoint allows API users to send an active scheduled document invite immediately, bypassing the originally scheduled time. After the invite is sent, the scheduled record is removed from the `active` status.

## Response `200`

The scheduled invite was sent. The response depends on the invite type:

* Field invite: an object with `status`.
* Freeform invite: an array with one object that contains `result`, `id`, and `callback_url`.

- object: For a freeform invite, the response is an array of objects with `result`, `id`, and `callback_url`.
  - `id` string: Freeform invite only. ID of the freeform invite.
  - `result` string: Freeform invite only. Result of the request. Always `success`.
  - `status` string: Field invite only. Result of the request. Always `success`.
  - `callback_url` string: Freeform invite only. Callback URL of the invite. `none` when no callback is set.

## Other responses

- `400`: Errors: * The document does not have an active scheduled invite. * The user is not the document owner.

---

[API](https://skmtc.dev/signnow/apis/signnow-api.md) - [All operations](https://skmtc.dev/signnow/apis/signnow-api/llms.txt) - [OpenAPI document](https://skmtc.dev/signnow/apis/signnow-api/revisions/1c9c30a6142b?raw)