Please check our API Overview before continuing.

User endpoint base is user/ so for version 1 of our API you will use:

Return user information [GET]

Return example:
{
 "email: "[email protected]",
 "isSubscribed": true,
 "gender": "male",
 "city" : "Paris"
}

Add new user [POST]

Create a new user, if the email does not exists.

Request example:
{
 "email: "[email protected]",
 "isSubscribed": true,
 "gender": "male"
}

Update user attributes [PUT]

Modify user attributes. Make sure you submit valid data for the attributes, otherwise they will be ignored.

Request example:
{
 "isSubscribed": true,
 "gender": "male"
}

We accept upsert for PUT requests, if you pass it as URL param. When upsert is true, it will create the user, if it doesn’t exist, otherwise it will update the object.

PUT /{email}?upsert=true

Responses examples:

{
  "results": {
    "message": "Successfully added new user.",
    "email": "[email protected]"
  }
}

{
  "errors": [
    {
      "message": "User not found",
      "description": "This email does not exist in our database."
    }
  ]
}

{
  "errors": [
    {
      "message": Invalid data format/type",
      "description": "Error validating user attributes",
    }
  ]
}