v1Resources/Social Listening/postCreate a theme
Create a theme
Creates a theme from a rule you write. It is pinned, so it stays as you define it.
post
listening:write/api/v1/listening/themesRequest body
clientIdstringrequired
The client (business) this concerns.
labelstringrequired
The theme's name, up to 60 characters.
rulearray of objectrequired
The theme's rule: 1 to 5 term groups that must all match, each { match: "all" | "any", terms: [...] }.
Response
dataobjectoptional
themeobjectoptional
The theme that was created.
Errors
400The request is missing a required parameter or is otherwise malformed.
401Missing, invalid, expired, or revoked API key.
403The key lacks the required scope, or isn't authorized for this client/location.
404The resource wasn't found, or doesn't belong to your agency.
429Too many requests. Retry after the number of seconds in the Retry-After header.
post/api/v1/listening/themes
Your API key
Request body*
{}