Retrieve a recommendation
Retrieve a specific recommendation by its unique identifier. This endpoint is useful for accessing detailed information about a particular recommendation within your HubSpot account.
Supported products
Supported products
Required scopes
Required scopes
Authorizations
The access token received from the authorization server in the OAuth 2.0 flow.
Path Parameters
The unique identifier of the recommendation to retrieve.
Response
successful operation
The date and time when the recommendation was created, in ISO 8601 format.
The end date for the recommendation's relevance, formatted as a date.
The unique identifier for the recommendation.
An array of strings representing citations that influenced the recommendation.
An array of strings representing the IDs of prompts that influenced this recommendation.
The type of recommendation provided. Valid values include 'DOMAIN', 'URL', 'TECHNICAL', and 'CONTENT'.
CONTENT, DOMAIN, TECHNICAL, URL The start date for the recommendation's relevance, formatted as a date.
The current status of the recommendation. Valid values include 'NEW', 'IN_PROGRESS', 'COMPLETED', 'ARCHIVED', 'FAILED', 'DISMISSED', and 'DRAFT_CREATED'.
ARCHIVED, COMPLETED, DISMISSED, DRAFT_CREATED, FAILED, IN_PROGRESS, NEW The category of action suggested by the recommendation. Valid values include 'CREATE_CONTENT', 'UPDATE_CONTENT', 'OUTREACH', and 'UPDATE_ROBOTS'.
CREATE_CONTENT, OUTREACH, UPDATE_CONTENT, UPDATE_ROBOTS The channel through which the recommended action should be taken. Valid values include 'YOUTUBE', 'LINKEDIN', 'REDDIT', 'AFFILIATE', 'PR', 'PEER', 'REVIEW_SITE', 'TECHNICAL_SEO', 'OWNED_CONTENT', 'LINKEDIN_ARTICLE', and 'LINKEDIN_POST'.
AFFILIATE, LINKEDIN, LINKEDIN_ARTICLE, LINKEDIN_POST, OWNED_CONTENT, PEER, PR, REDDIT, REVIEW_SITE, TECHNICAL_SEO, YOUTUBE The answer engine used to generate the recommendation. Valid values include 'CHATGPT', 'GEMINI', and 'CLAUDE'.
CHATGPT, CLAUDE, GEMINI The URL of the content associated with the recommendation.
A string representing the topic of the content related to the recommendation.
The type of content associated with the recommendation. Valid values include 'UNKNOWN', 'LISTICLE', 'COMPARISON', 'PRODUCT', 'BLOG', 'DOCUMENTATION', 'WIKI', 'NEWS', 'PR', 'RESEARCH', 'USER_REVIEW', 'SOCIAL', 'HOW_TO', 'GUIDE', 'EDUCATIONAL', 'HOMEPAGE', 'MULTIMEDIA', 'ARTICLE', and 'DOMAIN'.
ARTICLE, BLOG, COMPARISON, DOCUMENTATION, DOMAIN, EDUCATIONAL, GUIDE, HOMEPAGE, HOW_TO, LISTICLE, MULTIMEDIA, NEWS, PR, PRODUCT, RESEARCH, SOCIAL, UNKNOWN, USER_REVIEW, WIKI The domain associated with the recommendation.
The justification for why the recommendation was made.
The priority level of the recommendation. Valid values include 'HIGH', 'MEDIUM', and 'LOW'.
HIGH, LOW, MEDIUM A summary of the recommendation provided.
The URL associated with the recommendation.