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:
    h    ttps://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}

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 error cases

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"
}