Create Topics

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

Request Type

  • POST

Scope

  • ZohoCampaigns.contact.CREATE 

Request URL

  • Brand Topic:
    https://campaigns.zoho.com/api/v1.1/topics?details={topic_name:aaa,topic_desc:bbb}
  • Brand Product Topic: 
    https://campaigns.zoho.com/api/v1.1/topics?details={topic_name:aaa,topic_desc:bbb,product_id:74726000000064001}

API Limit

  • Duration: 5 mins
  • Number of Calls: 500
  • Lock Period: 30 mins

You can send 500 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.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 contacts

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

Possible Errors

Error code

Description

4016

The topic associated with contacts 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://campaigns.zoho.com/api/v1.1/topics?details={topic_name:aaa,topic_desc:bbb}

https://campaigns.zoho.com/api/v1.1/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.1/topics"
}

Brand Product Topic
{
    "code": "200",
    "topic_id": "74726000000418001",
    "message": "Success",
    "uri": "/api/v1.1/topics"
}