Create a new keyword

PUT /keywords/v1/keywords(.json)

Method Details

HTTP Methods:

PUT

Content Type:

application/json

Response Format:

json

Requires Authentication?

Yes

Rate Limited?

Yes

Headers

User-Agent

Products:

Marketing

Create a new keyword in a given HubSpot Portal.

Required Parameters How to use Description
OAuth Access Token or API Key Authorization: Bearer {token} header
or hapikey={key} query parameter.
Used to authenticate the request. Please see this page for more details about authentication.
Keyword JSON Used in the request body. The name of the keyword you're creating. This should be a simple JSON object, as seen in the example below.
Optional Parameters How to use Description
None None No optional parameters for this method.

Example URL:  https://api.hubapi.com/keywords/v1/keywords?hapikey=demo

If you try to create a keyword that already exists in a particular portal, the API will return an HTTP 201 response to you, but there will be nothing in the response body (the keyword will not be returned in the response body).