Skip to content

Atto Developer Documentation (all)

Download OpenAPI description
Languages
Servers
UK Environment (Production)

https://uk.api.atto.co/

US Environment (Production)

https://us.api.atto.co/

Operations
Operations

Request

Security
Bearer
Path
invitationIdstringrequired
curl -i -X GET \
  'https://uk.api.atto.co/connect-invitations/v1/{invitationId}' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

Successful email invitation retrieval

Bodyapplication/json
dataobject(EmailInvitationActivity)
metaobject(Meta)
Response
application/json
{ "data": { "invitationId": "550a4884-8473-4f2e-a6cf-551c16767d59", "recipientName": "string", "recipientEmail": "string", "customerReference": "string", "invitationCreated": "2019-08-24T14:15:22Z", "activities": [] }, "meta": { "totalRecords": 0 } }

Request

Security
Bearer
Body

Request details including recipient name, email, etc

templateIdstring or null

Template ID to be used for the email, if not specified the default template from configuration will be used

recipientNamestringnon-empty^([\u00c0-\u01ffa-zA-Z'\d_. \+\-\(\)]){1,100}...required

Name of the recipient (e.g. full name of the person)

recipientEmailstring(email)non-empty^[\u00c0-\u01ffa-zA-Z0-9_\.-]+@([\u00c0-\u01f...required

Email address of the recipient to whom the email is going to be sent

customerReferencestringnon-empty^[a-zA-Z\d_. \+\-\(\)]{1,100}$required

Customer reference for this recipient, an example would be a unique identifier of this user in customer's internal systems

curl -i -X POST \
  https://uk.api.atto.co/connect-invitations/v1 \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json-patch+json' \
  -d '{
    "templateId": "string",
    "recipientName": "string",
    "recipientEmail": "user@example.com",
    "customerReference": "string"
  }'

Responses

Email Invitation request sent

Headers
Locationstring
Bodyapplication/json
dataobject(ConnectInvitation)
metaobject(Meta)
Response
application/json
{ "data": { "invitationId": "550a4884-8473-4f2e-a6cf-551c16767d59" }, "meta": { "totalRecords": 0 } }
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations