Create an Observer
POST/agreements/:agreement_id/observers
Creates a new observer. Use the observer ID in subsequent requests.
Request
Path Parameters
POST /agreements/:agreement_id/observers parameter
- application/json
Body
POST /agreements/:agreement_id/observers request body
The email of the observer. Will be used in all communication, if email communication is enabled for the agreement.
The name of the observer
Possible values: [viewer
, cc
]
Default value: viewer
Either "viewer" or "cc". If the observer is a viewer, they will gain access to the signing room. Otherwise they will only receive a copy of the signed document.
Possible values: [sv-SE
, en-US
]
Default value: sv-SE
Optional. The locale for the observer. Can be overridden by the observer in the signing room (if observer_Scope is 'viewer'), but the locale provided by you will serve as the default in initial communication. If not specified, the default locale for the agreement will be used.
Responses
- 200
- 400
POST /agreements/:agreement_id/observers Successful response
- application/json
- Schema
- Example (from schema)
Schema
Possible values: [1.0
]
The version of the response schema
Possible values: [single
]
A single object of the observer resource.
Possible values: [observer
]
Data contains the observer resource.
data objectrequired
The resource data.
The unique identifier of the observer
Possible values: [observer
]
The name of the observer. Required if no email is provided.
The email of the observer. Required if agreement is configured to send emails or if the observer_scope is 'cc'.
Possible values: [sv-SE
, en-US
]
The locale for the observer. Can be overridden from the signing room (if the observer_scope is 'viewer'), but this value serves as the default if nothing else is specified.
Possible values: [cc
, viewer
]
The scope of the observer. If specified as viewer, they will gain access to the signing room to follow the process. Otherwise, they will only receive the final, signed document.
The unique identifier for the agreement this observer belongs to
The URL to the signing room for the observer. Only available after the agreement is not in draft.
UTC datetime ISO string
UTC datetime ISO string
{
"version": "1.0",
"result_type": "single",
"resource_type": "observer",
"data": {
"id": "cplmiwtmfefybclyzqeexample",
"resource_type": "observer",
"name": "Jane Doe",
"email": "jane.doe@example.com",
"locale": "sv-SE",
"observer_scope": "cc",
"agreement": "cbzztybtsumz8khvjs3example",
"signing_room_url": "https://www.zigned.se/sign/cvoppq9maacmsg0uh5nexample/c5keltbncihl7floagsexample",
"created_at": "2024-01-01T00:00:00.000Z",
"updated_at": "2024-01-01T00:00:00.000Z"
}
}
POST /agreements/:agreement_id/observers Error response
- application/json
- Schema
- Example (from schema)
Schema
Possible values: [error
]
error objectrequired
Possible values: >= 400
and <= 599
{
"status": "error",
"error": {
"code": 0,
"message": "string",
"request_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
}
}