Create a Participant

POST 
/agreements/:agreement_id/participants

Creates a new participant in draft status. Use the participant ID in subsequent requests.

Request

Path Parameters

agreement_id cuidrequired

POST /agreements/:agreement_id/participants parameter

application/json

Body

POST /agreements/:agreement_id/participants request body

email email

The email of the participant. Will be used in all communication, if email communication is enabled for the agreement.

name string

The name of the participant. If omitted, the email adress will be used as name.

role string

Possible values: [signer, approver]

Default value: signer

The role of the participant within the signing process. If the agreement is configured for qualified signatures, only "signer" is supported. Default role is "signer".

personal_number string

The personal number of the participant. If provided, the signer will have to use an advanced signing method that supports a swedish personal number to sign the agreement and only be allowed to sign if the personal number matches what is provided. Only available for signers.

order int64

Possible values: >= -9007199254740991 and <= 9007199254740991

Only applicable if signing order is enabled for the agreement. It specifies the order in the signing queue this participant will have. Will be put last in line if not specified. If multiple participants share the same queue number, this participant will take precendent and the rest will be moved forward accordingly.

Responses

200

POST /agreements/:agreement_id/participants Successful response

application/json

Schema

Schema

version stringrequired

Possible values: [1.0]

The version of the response schema

result_type stringrequired

Possible values: [single]

A single object of the participant resource.

resource_type stringrequired

Possible values: [participant]

Data contains the participant resource.

data object

The participant resource

oneOf

MOD1

role stringrequired

Possible values: [approver]

The role of the participant

decision_made_at stringnullablerequired

UTC datetime ISO string

MOD2

role stringrequired

Possible values: [signer]

The role of the participant

signed_at stringnullablerequired

UTC datetime ISO string

signature object nullable required

The signature data for the participant

oneOf

MOD1

id cuidrequired

The unique identifier of the signature data

created_at stringrequired

UTC datetime ISO string

updated_at stringrequired

UTC datetime ISO string

MOD2

method nullnullablerequired

data nullnullablerequired

identity_enforcement object required

oneOf

MOD1

enabled booleanrequired

Possible values: [true]

If true, identity enforcement is enabled for the participant

status stringrequired

Possible values: [pending, passed, failed]

The status of the identity enforcement

enforcement_method stringrequired

Possible values: [swe_pno_crosscheck]

The enforcement method for the identity. Depending on which method is used, different signature method are available

MOD2

enabled booleanrequired

Possible values: [false]

If true, identity enforcement is enabled for the participant

status nullnullablerequired

enforcement_method nullnullablerequired

id cuidrequired

The unique identifier of the participant

resource_type stringrequired

Possible values: [participant]

name stringnullablerequired

The name of the participant. Required if no email is provided.

email stringnullablerequired

The email of the participant. Required if agreemnt is configured to send emails.

status stringrequired

Possible values: [draft, pending, initiated, processing, fulfilled, rejected]

The status of the participant

order doublenullablerequired

Possible values: <= 1.7976931348623157e+308

The queue number of the participant (if sequential signing order is enabled)

signing_group object required

oneOf

MOD1

string

118cb3b11b8a1f3b6b1e60a89f96a8be9da32a0f

version stringrequired

Possible values: [1.0]

The version of the response schema

result_type stringrequired

Possible values: [single]

A single object of the signing_group resource.

resource_type stringrequired

Possible values: [signing_group]

Data contains the signing_group resource.

data objectrequired

The resource data.

id cuidrequired

The unique identifier of the signing group

resource_type stringrequired

Possible values: [signing_group]

name stringrequired

The name of the signing group

status stringrequired

Possible values: [draft, pending, fulfilled]

The status of the signing group

order doublerequired

Possible values: >= 5e-324 and <= 1.7976931348623157e+308

The queue number of the signing group

participants object required

oneOf

MOD1

Array [

string

]

MOD3

string

agreement cuidrequired

The unique identifier of the agreement this signing group belongs to

created_at stringrequired

UTC datetime ISO string

updated_at stringrequired

UTC datetime ISO string

MOD3

string

agreement cuidrequired

The unique identifier for the agreement this participant belongs to

signing_room_url urlnullablerequired

The URL to the signing room for the participant. Only available after the agreement has been finalized for signing.

created_at stringrequired

UTC datetime ISO string

updated_at stringrequired

UTC datetime ISO string

Example (from schema)

{
  "version": "1.0",
  "result_type": "single",
  "resource_type": "participant",
  "data": {
    "role": "approver",
    "decision_made_at": "2024-01-01T00:00:00.000Z"
  }
}

400

POST /agreements/:agreement_id/participants Error response

application/json

Schema

Schema

status stringrequired

Possible values: [error]

error objectrequired
code int64required
Possible values: >= 400 and <= 599
message stringrequired
request_id uuidrequired

Example (from schema)

{
  "status": "error",
  "error": {
    "code": 0,
    "message": "string",
    "request_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
  }
}

Loading...