Method Details
HTTP Methods:
POST
Content Type:
application/json
Response Format:
json
Requires Authentication?
Yes
Rate Limited?
Headers
Products:
Marketing
Required Scope:
Create a Blog Author.
There's a new version of the HubSpot API
As of November 30, 2022, HubSpot API keys are no longer a supported authentication method for accessing HubSpot APIs. Instead, you should use a private app access token or OAuth to authenticate API calls. Learn more about this change and how to migrate an API key integration to use a private app instead.
HTTP Methods:
POST
Content Type:
application/json
Response Format:
json
Requires Authentication?
Yes
Rate Limited?
Headers
Products:
Marketing
Required Scope:
Create a Blog Author.
Required Parameters | How to use | Description |
---|---|---|
OAuth access token or private app access token | Authorization: Bearer {token} header | Used to authenticate the request. Please see this page for more details about authentication. |
Parameter name | Type | Description |
---|---|---|
string | The email address of the blog author | |
fullName | string | The first and last name of the blog author |
userId | Long | The HubSpot user id of the blog author |
username | string | The HubSpot username of the blog author |
bio | string | A short biographay of the blog author |
website | string | Url linking to a blog author page |
string | URL or username of the twitter account associated with the author. This will be normalized into the twitter url for said user | |
string | URL to the blog author's linkedin page | |
string | URL to the blog author's facebook page | |
googlePlus | string | URL to the blog author's Google+ page |
avatar | string | URL to the blog author's avatar, if supplying a custom one |
Parameter name | Description |
---|---|
casing | Use the casing=snake parameter to change the API's casing for all query parameters (including those above) and JSON fields (below) to snake_case, rather than camelCase, which is the default. This option is provided for backwards-compatibility and ease of migration from Content v2 APIs, which used snake_case. |
Field name | Type | Description |
---|---|---|
id | string | The unique id of the author |
portalId | string | The hub id |
created | long | When the author was first created, in milliseconds since the epoch |
updated | long | When the author was last updated, in milliseconds since the epoch |
deletedAt | long | When the author was deleted, in milliseconds since the epoch. Zero if the author was never deleted. Use a DELETE request to properly soft delete an author - do not set this value directly. |
fullName | string | The full name of the author |
string | The email address of the author | |
userId | Long | The userid of the author, if associated with a hubspot account |
username | string | The username of the author, if associated with a hubspot account |
slug | string | The URL-friendly version of the author, used in blog urls |
publicUrl | string | Author url based on your primary blog |
displayName | string | The display name of the author |
bio | string | Author's bio text |
googlePlus | string | Author's Google Plus url |
website | string | Author's website url |
string | Author's twitter url | |
string | Author's LinkedIn url | |
string | Author's Facebook url | |
avatar | string | Author's avatar url |
gravatarUrl | string | Author's gravatar url |
twitterUsername | string | Author's twitter username, generated from their twitter url |
hasSocialProfiles | boolean | true if at least one social network (facebook, twitter, googlePlus, likedin) has a url |