curl -X POST "https://api.manychat.com/fb/subscriber/addTagByName" -H "accept: application/json" -H "Authorization: Bearer 0" -H "Content-Type: application/json" -d "{ \"subscriber_id\": 0, \"tag_name\": \"string\"}"

You need to replace the 0’s and “string” in the command with the appropriate data. I’ll show you how to use this and what it does below.

The purpose of this API call is to assign a new TAG by NAME to your ManyChat subscriber. This API requires a Tag NAME which is a lot easier than the Tag ID. However the downside is if you use it via forms, the spaces or special characters in the form entry fields, may be altered by PHP. Forexample, a space might be translated into an underscore (_). If you use your own fixed code, or verification methods, you’ll fine fine!

Your Tag must pre-exist

Why would you need this?

The reasons for needing this, are obviously identical to those of the addTag via an ID. It’s just a different approach. If you want to TAG users for specific actions in your system, for example a completed step in your flow, this TAG has to pre-exist. With this API call you can create such a TAG automatically. Once your Tag is created, you can assign it to a user with this API. It’s a nice tool if you want to segment your users from your own CMS or (ecom) platform. You can document the entire path your user takes in your bot.

This is the default response on a successful request

{
  "status": "success"
}

So how do we use this in our own system?

First we will add a new function to our class file in classes/manychat.class.php.

    /**
     * 
     * @param type $subscriber_id
     * @param type $tag_name
     * @param type $mc_api
     * @return boolean
     */
    function subscriberAddTagByName($subscriber_id, $tag_name, $mc_api)
    {

        $postfields_arr = [
            'subscriber_id' => $subscriber_id,
            'tag_name'        => $tag_name
        ];

        $postfields = json_encode($postfields_arr);

        $ch            = curl_init();
        curl_setopt($ch, CURLOPT_URL, "https://api.manychat.com/fb/subscriber/addTagByName");
        curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'POST');
        curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
        curl_setopt($ch, CURLOPT_POSTFIELDS, $postfields . PHP_EOL);
        $headers       = [
            'Authorization: Bearer ' . preg_replace("/^(\w+\s+)/", "", $mc_api),
            'Content-Type: application/json',
            'Accept: application/json'
        ];
        curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
        $server_output = curl_exec($ch);
        curl_close($ch);

        $json_obj  = json_decode($server_output);
        $good_call = $json_obj->status;

        if ($good_call == "success") {
            return true;
        } else {
            return false;
        }
    }

After we created the new function, we will create a new PHP file and call it subscriber_addtagbyname.php. It look like this:

<?php

/*
 * Load the ManyChat Config File
 */
require_once './config.inc.php';

/*
 * Set a Tag to a Subscriber with addTag by Name
 */

$subscriber_id     = "1929189923777499";
$tag_name            = "Received Coupon";
$subscriber_addtag = $mc->subscriberAddTagByName($subscriber_id, $tag_name, $mc_api);

if ($subscriber_addtag) {
    echo "Successfully added tag ID $tag_name to user $subscriber_id";
}

$subscriber_addtag will return TRUE for a correct response, which will allow us to report back the result.

What is your use case?