Action: Assign tag to a lead

Assigns a tag to a specified lead. Note that you must have previously created the tag in your Kartra account (https://app.kartra.com/communication/tags).


Type Parameters Values
POST cmd* assign_tag
POST tag_name* string

* Required fields

Here is an example:

'lead' => [
    'email' => 'example@email.com'
'actions' => [
    '0' => [
        'cmd' => 'assign_tag',
        'tag_name' => 'tag name'

Success message:

  "status": "Success",
  "message": "The tag {tag_name} will be added to lead in a few moments",
  "type": "103"

Error Cases:

Type Number Message Cause
211 tag_name cannot be empty. Nothing done
  • ‘tag_name’ parameter it is mandatory and cannot be empty.
212 tag does not exist. Nothing done
  • The tag is not in our database.

An example of an error message:

  "status": "Error",
  "message": "tag_name cannot be empty. Nothing done",
  "type": "211"

© 2021 Kartra All Rights Reserved