Create a contact

Add a contact to the organization.

Submit Feedback: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team.

To use this endpoint, select Write Alert Contacts under the Setup & Administration category when creating or editing an API token. Learn More.

POST /contacts

Create a contact

cURL

curl --request POST \
  --url https://api.samsara.com/contacts \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "email": "[e-mail]",
  "firstName": "Jane",
  "lastName": "Jones",
  "phone": "111-222-3344"
}
'

200

{
  "data": {
    "email": "[e-mail]",
    "firstName": "Jane",
    "id": "22408",
    "lastName": "Jones",
    "phone": "111-222-3344"
  }
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

The contact create parameters.

Information for adding a notification contact for alerts.

email · string

Email address of the contact.

Maximum string length: 255

Example:

"[e-mail]"

firstName · string

First name of the contact.

Maximum string length: 255

Example:

"Jane"

lastName · string

Last name of the contact.

Maximum string length: 255

Example:

"Jones"

phone · string

Phone number of the contact.

Maximum string length: 255

Example:

"111-222-3344"

Response

200

application/json

Contact was successfully added.

A single contact.

data · object

Information about a notification contact for alerts.

Show child attributes