Overview

Use this method to add custom tags to applicant profiles and overwrite the existing ones.

📘

Info

• The maximum number of tags in an applicant profile is limited to 30. To remove unnecessary tags, use this method.
• To add new tags without overwriting the old ones, use this method.
• To manage tags added with this method, use the Tags page in the Dashboard.

😀

Did you know?

You can also add custom tags from the Dashboard.

Request example

curl -X POST 'https://api.sumsub.com/resources/applicants/5fd1012c885b5d0009d50e6e/tags' \
  -H 'Content-Type: application/json' \
  -d '["Approved Sanctions", "Approved PEP", "821"]'

Response explained

If the tags are created and assigned correctly, you will get the following response:

{
    "ok": 1
}

If the request fails, you will receive an HTTP response containing an error code along with a message explaining the error.

For example:

{
  "description": "Invalid id 'xxxxxxxxxx'",
  "code": 400,
  "correlationId": "77b612a1bb281c64c132dd0000000000"
}