Replen.it

View Categories

Upsert User API

Replenit Upsert API allows you to send user attributes and events to Replenit, enabling the insertion and updating of user data from different endpoints.

Base URL: https://services.replen.it

Authorization: All routes require a Bearer Token with the correct permission level in the “Authorization” header. 

Please contact your CSM to receive your client ID and Bearer Token details.

Endpoints:

  • User Upsert (Single) -POST: https://services.replen.it/users/{clientId}/upsert
    • Inserts or updates a single user.

Sample Payload:

{
  "identifiers": {
    "userId": "string",
    "email": "[email protected]"
  },
  "attributes": {
    "name": "string",
    "surname": "string",
    "username": "string",
    "phone": "string",
    "emailOptin": true,
    "smsOptin": true,
    "whatsappOptin": true,
    "gdprOptin": true,
    "language": "string",
  }
}
  • Note: The primary identifier can be either user ID or email address. If you do not have a user ID, leave it empty, and it will be presented as null.
  • User Upsert -Mass (POST): https://services.replen.it/users/{clientId}/upsert-bulk
    • Inserts or updates multiple users.

Sample Payload:

[
  {
    "identifiers": {
      "userId": "string",
      "email": "[email protected]"
    },
    "attributes": {
      "name": "string",
      "surname": "string",
      "username": "string",
      "phone": "string",
      "emailOptin": true,
      "smsOptin": true,
      "whatsappOptin": true,
      "gdprOptin": true,
      "language": "string",
      "locale": "string"
    }
  }
]
  • Note: The primary identifier can be either user ID or email address. If you do not have a user ID, leave it empty, and it will be presented as null.
  • Update User Email (PUT): https://services.replen.it/users/{clientId}/update-user-email
    • Updates the email address of a user.

Sample Payload:

{
  "identifiers": {
    "userId": "string",
    "email": "[email protected]"
  }
}
  • Update User ID (PUT): https://services.replen.it/users/{clientId}/update-user-id
    • Updates the user ID of a user.

Sample Payload:

{
  "identifiers": {
    "userId": "string",
    "email": "[email protected]"
  }
}
  • Delete User (DELETE): https://services.replen.it/users/{clientId}?identifier={firstIdentifier}
    • Deletes a user using the primary identifier.

Sample Payload:

{
  "identifiers": {
    "userId": "string",
    "email": "[email protected]"
  }
}