Contacts
Add a contact
POST
To your own list, or with shared to the company’s (for those who manage contacts). An address already there returns that contact unchanged, with 200 rather than 201. Send an Idempotency-Key: the same key returns the same answer for 24 hours.
bearerheader
AuthorizationBearer <token>An access token from /v1/auth/token, or a personal token: opaque, beginning s2a_.
workspace_id*stringwsp_…, from GET /v1/me
Length
length <= 40idempotency-key*stringA UUID of your own (ADR 0071 §5)
Match
^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$Format
uuidapplication/json- body
email*stringMatch
^(?:[A-Za-z0-9_'+\-]+\.)*[A-Za-z0-9_'+\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$Format
emailLength
length <= 254first_name?stringLength
length <= 80last_name?stringLength
length <= 80job_title?stringLength
length <= 120phone?stringLength
length <= 40organisation_id?stringorg_…
Length
length <= 40shared?booleanAlready there
application/json- response
Already there
id*stringcon_…
name*stringemail*stringjob_title*string|nullphone*string|nullorganisation*|nullmine*booleanIn your own list rather than the company’s
curl -X POST 'https://api.sign2approve.com/v1/workspaces/string/contacts' \ -H 'idempotency-key: 497f6eca-6276-4993-bfeb-53cbbbba6f08' \ -H 'Content-Type: application/json' \ -d '{ "email": "[email protected]"}'{ "id": "con_01a16d3fd3507be78e41c4540aa20a3c", "name": "Pat Client", "email": "[email protected]", "job_title": "Director", "phone": null, "organisation": { "id": "org_01a16d3fd3507be78e41c4540aa20a3d", "name": "Client Ltd" }, "mine": true}