Keywords API Methods

Delete a Keyword

DELETE  /keywords/v1/keywords/:keyword_guid

Delete a keyword in a given HubSpot Portal.

If the keyword is successfully deleted, you will get back a 200 response with an empty JSON string ({}). Otherwise, you'll get an error.

Note: deleting a keyword is a soft operation. It disappears from the user interface, but all its historical data remains in our database.

Required Parameters How to use Description
Keyword GUID Used in the request URL Unique identifier for a particular keyword that you're deleting.
HubSpot OAuth Access Token access_token=X - Used in the request URL The HubSpot API key for the portal that you're making the call for.
Optional Parameters How to use Description
None None No optional parameters for this method.

Example URL:  https://api.hubapi.com/keywords/v1/keywords/6bde2815-81b8-452c-81dd-7854551bab8d?access_token=demooooo-oooo-oooo-oooo-oooooooooooo

Example JSON response body. If the deletion succeeds, the API will return an empty JSON object:

        {}
    

The response from this API call are standard REST-style HTTP response codes that mark success or failure, with meta information about the call that was made. There will be no data in the response body.

  • 201 when a keyword is deleted
  • 401 when an unauthorized request is made
  • 500 when an internal server error occurs