Create Topics

This API helps you create topics to associate to leads in a mailing list.

Request type

POST

Scope required

ZohoMarketingAutomation.lead.CREATE

Request URL

Brand Topic:

https://ma.zoho.com/api/v1/topics?details={topic_name:aaa,topic_desc:bbb}

Brand Product Topic:

https://ma.zoho.com/api/v1/topics?details={topic_name:aaa,topic_desc:bbb,product_id:74726000000064001}

API Limit

Duration: 5 mins
Number of Calls: 100
Lock Period: 30 mins

You can send 100 API calls per 5 minutes. If you hit this limit, you can't use this API for the next 30 minutes due to security reasons, but you can still use other APIs if their lock period hasn’t been reached.

List of parameters - Version 1

Parameter	Data Type	Description
topic_desc*	String	A description about the topic
topic_name*	String	Name of the topic to be created
product_id	String	Product ID of the topic associated to leads

* - Mandatory Parameters (For brand topic the product_id is mandatory)

Possible error cases

Error code	Description
4016	The topic associated with leads not enabled
4010	No privilege
4011	Topic name cannot contain special characters
4012	Topic description cannot contain special characters
4013	Topic name already exists
4017	Topic name cannot be empty
4018	Topic description cannot be empty

If your error code is not listed above, click here.

Sample request

Copiedhttps://ma.zoho.com/api/v1/topics?details={topic_name:aaa,topic_desc:bbb}
https://ma.zoho.com/api/v1/topics?details={topic_name:aaa,topic_desc:bbb,product_id:74726000000064001}

Sample Response

CopiedBrand Topic : 

{
    "code": "200",
    "topic_id": "74726000000418001",
    "message": "Success",
    "uri": "/api/v1/topics"
}

Brand Product Topic

{
    "code": "200",
    "topic_id": "74726000000418001",
    "message": "Success",
    "uri": "/api/v1/topics"
}