/procedures
POST {{base-api-url}}/procedures
Subscribers in the procedure are simply and directly managed at the procedure level in the same way as members.
Request Body
{"name"=>"My first procedure with subscribers", "description"=>"Awesome, here is my sample of procedure with subscribers", "start"=>true, "members"=>[{"firstname"=>"John", "lastname"=>"Doe", "email"=>"john.doe@yousign.fr", "phone"=>"+33612345678", "fileObjects"=>[{"position"=>"183,511,285,591", "page"=>2, "file"=>"/files/XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"}]}], "subscribers"=>[{"email"=>"billing@yousign.fr", "group"=>"group-0"}, {"email"=>"account@yousign.fr", "group"=>"group-0"}, {"email"=>"hr@yousign.fr", "group"=>"group-1"}]}
HEADERS
Key | Datatype | Required | Description |
---|---|---|---|
Authorization | string | This value is a secret and needs to be replaced by your API Key (Bearer). | |
Content-Type | string | This header specifies the format of the exchanges in JSON. |
RESPONSES
status: Created
{"id":"/procedures/XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX","name":"My first procedure with subscribers","description":"Awesome, here is my sample of procedure with subscribers","createdAt":"2018-12-02T12:17:44+01:00","updatedAt":"2018-12-02T12:17:44+01:00","finishedAt":null,"expiresAt":null,"status":"active","creator":null,"creatorFirstName":null,"creatorLastName":null,"workspace":"/workspaces/XXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX","template":false,"ordered":false,"parent":null,"metadata":[],"config":[],"members":[{"id":"/members/XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX","user":null,"type":"signer","firstname":"John","lastname":"Doe","email":"john.doe@yousign.fr","phone":"+33612345678","position":1,"createdAt":"2018-12-02T12:17:44+01:00","updatedAt":"2018-12-02T12:17:44+01:00","finishedAt":null,"status":"pending","fileObjects":[{"id":"/file_objects/XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX","file":{"id":"/files/XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX","name":"The best name for my file.pdf","type":"signable","contentType":"application/pdf","description":null,"createdAt":"2018-12-02T12:17:18+01:00","updatedAt":"2018-12-02T12:17:44+01:00","sha256":"bb57ae2b2ca6ad0133a699350d1a6f6c8cdfde3cf872cf526585d306e4675cc2","metadata":[],"workspace":"/workspaces/XXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX","creator":null,"protected":false,"position":0,"parent":null},"page":2,"position":"183,511,285,591","fieldName":null,"mention":null,"mention2":null,"createdAt":"2018-12-02T12:17:44+01:00","updatedAt":"2018-12-02T12:17:44+01:00","parent":null,"reason":"Signed by Yousign"}],"comment":null,"notificationsEmail":[],"operationLevel":"custom","operationCustomModes":["sms"],"operationModeSmsConfig":null,"parent":null}],"subscribers":[{"id":"/subscribers/XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX","email":"billing@yousign.fr","createdAt":"2018-12-02T12:17:44+01:00","updatedAt":"2018-12-02T12:17:44+01:00","group":"group-0"},{"id":"/subscribers/XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX","email":"account@yousign.fr","createdAt":"2018-12-02T12:17:44+01:00","updatedAt":"2018-12-02T12:17:44+01:00","group":"group-0"},{"id":"/subscribers/XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX","email":"hr@yousign.fr","createdAt":"2018-12-02T12:17:44+01:00","updatedAt":"2018-12-02T12:17:44+01:00","group":"group-1"}],"files":[{"id":"/files/XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX","name":"The best name for my file.pdf","type":"signable","contentType":"application/pdf","description":null,"createdAt":"2018-12-02T12:17:18+01:00","updatedAt":"2018-12-02T12:17:44+01:00","sha256":"bb57ae2b2ca6ad0133a699350d1a6f6c8cdfde3cf872cf526585d306e4675cc2","metadata":[],"workspace":"/workspaces/XXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX","creator":null,"protected":false,"position":0,"parent":null}],"relatedFilesEnable":false,"archive":false,"archiveMetadata":[],"fields":[],"permissions":[]}