Insert/update user API

This API adds or updates users. You can then use this data to target your surveys.

POST https://app.satismeter.com/api/users

Request headers

Authorization: Bearer API_KEY
Content-Type: application/json

• Replace API_KEY with your API key, which you find in Integration Settings > API.

Request body

{
  "userId": "007",
  "traits": {
    "name": "James Bond",
    "email": "007@sis.gov.uk",
    "createdAt": "2015-06-16T09:19:47.155Z",
    "plan": "Gold"
  },
"project": "PROJECT_ID"
}

• Replace PROJECT_ID with your project ID, which you find in Integration Settings > API.

Optional: Changing the next survey date for a user

You can change the date a user next sees the survey. Use this to survey someone earlier or later than their targeting rules would.

Request body

{
  "userId": "007",
"project": "PROJECT_ID",
  "surveyDate": "2100-01-01T00:00:00.000Z"
}