User.com REST API Docs

# Deal add tag by id

You can add a tag to a deal using a custom_id.

POST /deals-by-id/:custom_id/add_tag/

Attributes Type Required Description
custom_id string yes The unique identifier for the deal which is provided by the client.
name string yes A name of th the tag you want to add.

# Request

  • CURL
  • JavaScript
  • PHP
  • Python 
curl -X POST -H "Authorization: Token <your_64_char_api_key>" -H "Content-Type: application/json" 
       -H "Accept: */*; version=2" -d '{
      "name": "My tag"
    }' "https://<your_app_subdomain>.user.com/api/public/deals-by-id/:custom_id/add_tag/"

# Response

{
  "tag": {
    "name": "My tag"
  },
  "created": true
}

If created equals True: you did not have this tag before. False: you created this tag before, so it was re-used.

← Deal model →