Skip to content

Errors

Could Not Create Ceremony

A ceremony can't be created because the envelope or recipient status does not allow it. Check both statuses, then retry. Ceremonies need in_progress.

What Happened

The request to create a ceremony failed because of the current status of the envelope or the recipient. The detail property tells you which case applies:

  • The envelope is not in_progress. Ceremonies can be created while the envelope is in_progress. For recipients with manual ceremony creation, they can also be created while the envelope is processing.
  • The recipient has the wrong status. Ceremonies can only be created for recipients whose status is pending, awaiting, sent or soft_bounced. A completed, rejected, hard_bounced, failed or replaced recipient does not get a new ceremony.
  • The recipient’s request is still being sent. The recipient shows pending while its request email goes out. Try again in a moment.

Example response

409 Conflict (application/problem+json)
{
  "type": "https://signatureapi.com/docs/v1/errors/cannot-create-ceremony",
  "title": "Could Not Create Ceremony",
  "status": 409,
  "detail": "This recipient can't get a new ceremony right now because its request is still being sent. Try again in a moment."
}

How to Fix

  • Get the envelope and check that its status is in_progress.
  • Get the recipient and check its status. If the recipient is hard_bounced or failed, replace the recipient first.
  • If the detail says the request is still being sent, wait a few seconds and retry.

  Still stuck? Contact support.