Create merge tags

Send your campaigns by addressing your leads by their first name, last name or anything else you find appropriate. Using this API, youcan create merge tags.

Scope required

  • ZohoMarketingAutomation.lead.CREATE

Other alternative scopes

  • ZohoMarketingAutomation.lead.CREATE-UPDATE (CREATE + UPDATE)

  • ZohoMarketingAutomation.lead.WRITE (CREATE + UPDATE + DELETE)

  • ZohoMarketingAutomation.lead.ALL (CREATE + UPDATE + DELETE + READ)

Header:

Authorization: Zoho-oauthtoken <access_token>

Content-Type: application/x-www-form-urlencoded

Request type:

  • Post

Request URL

https://marketingautomation.zoho.com/api/v1/merge/create

List of parameters

Parameter

Data type

Description

type*

String

json

fieldname*

String

Alphanumeric

tagtype*

String

Custom

fieldtype*

String

  • Text
  • Integer
  • Phone
  • Date
  • Picklist
  • Email
  • Checkbox
  • LongInteger
  • URL
  • textarea
  • RadioOption
  • Multiselect
  • DateTime
  • Decimal
  • Percent

mailvalue

String

Give a default value for the tag to be used in email content.

socialvalue

String

Give a default value for the tag to be used in email content of social campaigns.

* - Mandatory parameters

Sample request

Copiedhttps://marketingautomation.zoho.com/api/v1/merge/create?type=json&mergename=providemergetagname&fieldname=providefiledname&tagtype=custom&fieldtype=Text&mailval=providemailval&socialval=providesocialval

Sample Response

Copied{
"response": {
"fieldtype": "Text",
"mandatory_check": "success",
"scope": "CampaignsAPI",
"ta gtype": "custom",
"code": "200",
"mailval": "providemailval",
"type": "json",
"uri": "/api/v1/merge/create",
"fieldname": "providefieldname",
"message": "Success",
"accesstoken": "[API Access_Token] ",
"mergename": "providemergetagname",
"socialval": "providesocialvalue"
}
}