Add a signer to a draft envelope

POST

/api/v1/envelopes/{id}/signers

curl --request POST \
  --url https://sign-api.binarybridges.co/api/v1/envelopes/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/signers \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "email": "example", "name": "example", "signOrder": 1 }'

• Production

Only valid while the envelope is a draft.

Authorizations

• clientCredentials

Parameters

Path Parameters

id

required

string format: uuid

Request Body^required

Media typeapplication/json

object

email

required

string

name

required

string

signOrder

integer format: int32

Example ^generated

{
  "email": "example",
  "name": "example",
  "signOrder": 1
}

Responses

201

Created

Media type*/*

object

email

required

string

id

required

string format: uuid

name

required

string

signOrder

required

integer format: int32

signedAt

string format: date-time

status

required

string

400

The request was malformed or failed validation.

Media typeapplication/json

object

code

required

string

error

required

string

message

required

string

path

required

string

quota

object

current

required

integer format: int64

dimension

required

string

limit

required

integer format: int64

status

required

integer format: int32

timestamp

required

string format: date-time

traceId

string

Example ^generated

{
  "code": "example",
  "error": "example",
  "message": "example",
  "path": "example",
  "quota": {
    "current": 1,
    "dimension": "example",
    "limit": 1
  },
  "status": 1,
  "timestamp": "2026-04-15T12:00:00Z",
  "traceId": "example"
}

401

No credentials, or a token this organisation’s credentials cannot present. Produced by the security filter chain, so there is no response body.

403

Authenticated, but the token lacks the role this operation requires. No response body.

404

No such resource, or it belongs to another organisation. Deliberately not a 403: a 403 across a tenant boundary confirms the id exists.

Media typeapplication/json

object

code

required

string

error

required

string

message

required

string

path

required

string

quota

object

current

required

integer format: int64

dimension

required

string

limit

required

integer format: int64

status

required

integer format: int32

timestamp

required

string format: date-time

traceId

string

Example ^generated

{
  "code": "example",
  "error": "example",
  "message": "example",
  "path": "example",
  "quota": {
    "current": 1,
    "dimension": "example",
    "limit": 1
  },
  "status": 1,
  "timestamp": "2026-04-15T12:00:00Z",
  "traceId": "example"
}

409

The resource is not in a state that allows this — for example sending an envelope that is already sent.

Media typeapplication/json

object

code

required

string

error

required

string

message

required

string

path

required

string

quota

object

current

required

integer format: int64

dimension

required

string

limit

required

integer format: int64

status

required

integer format: int32

timestamp

required

string format: date-time

traceId

string

Example ^generated

{
  "code": "example",
  "error": "example",
  "message": "example",
  "path": "example",
  "quota": {
    "current": 1,
    "dimension": "example",
    "limit": 1
  },
  "status": 1,
  "timestamp": "2026-04-15T12:00:00Z",
  "traceId": "example"
}

422

A domain rule rejected the request.

Media typeapplication/json

object

code

required

string

error

required

string

message

required

string

path

required

string

quota

object

current

required

integer format: int64

dimension

required

string

limit

required

integer format: int64

status

required

integer format: int32

timestamp

required

string format: date-time

traceId

string

Example ^generated

{
  "code": "example",
  "error": "example",
  "message": "example",
  "path": "example",
  "quota": {
    "current": 1,
    "dimension": "example",
    "limit": 1
  },
  "status": 1,
  "timestamp": "2026-04-15T12:00:00Z",
  "traceId": "example"
}

429

An organisation quota is exhausted.

Media typeapplication/json

object

code

required

string

error

required

string

message

required

string

path

required

string

quota

object

current

required

integer format: int64

dimension

required

string

limit

required

integer format: int64

status

required

integer format: int32

timestamp

required

string format: date-time

traceId

string

Example ^generated

{
  "code": "example",
  "error": "example",
  "message": "example",
  "path": "example",
  "quota": {
    "current": 1,
    "dimension": "example",
    "limit": 1
  },
  "status": 1,
  "timestamp": "2026-04-15T12:00:00Z",
  "traceId": "example"
}