GET
/
cms
/
v3
/
blogs
/
authors
Get all Blog Authors
curl --request GET \
  --url https://api.hubapi.com/cms/v3/blogs/authors \
  --header 'Authorization: Bearer <token>'
{
  "total": 123,
  "paging": {
    "next": {
      "link": "",
      "after": ""
    }
  },
  "results": [
    {
      "website": "<string>",
      "displayName": "<string>",
      "created": "2023-11-07T05:31:56Z",
      "facebook": "<string>",
      "fullName": "<string>",
      "bio": "<string>",
      "language": "af",
      "linkedin": "<string>",
      "avatar": "<string>",
      "translatedFromId": 123,
      "twitter": "<string>",
      "deletedAt": "2023-11-07T05:31:56Z",
      "name": "<string>",
      "id": "<string>",
      "updated": "2023-11-07T05:31:56Z",
      "email": "<string>",
      "slug": "<string>"
    }
  ]
}
Supported products
Requires one of the following products or higher.
Marketing HubMarketing HubProfessional
Sales HubSales HubFree
Service HubService HubFree
Content HubContent HubStarter

​
Required Scopes

This API requires one of the following scopes:
  • content

Authorizations

​
Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Query Parameters

​
createdAt
string<date-time>

Only return Blog Authors created at exactly the specified time.

​
createdAfter
string<date-time>

Only return Blog Authors created after the specified time.

​
createdBefore
string<date-time>

Only return Blog Authors created before the specified time.

​
updatedAt
string<date-time>

Only return Blog Authors last updated at exactly the specified time.

​
updatedAfter
string<date-time>

Only return Blog Authors last updated after the specified time.

​
updatedBefore
string<date-time>

Only return Blog Authors last updated before the specified time.

​
sort
string[]

Specifies which fields to use for sorting results. Valid fields are name, createdAt, updatedAt, createdBy, updatedBy. createdAt will be used by default.

​
after
string

The cursor token value to get the next set of results. You can get this from the paging.next.after JSON property of a paged response containing more results.

​
limit
integer

The maximum number of results to return. Default is 100.

​
archived
boolean

Specifies whether to return deleted Blog Authors. Defaults to false.

​
property
string

Response

200
application/json

successful operation

Response object for collections of blog authors with pagination information.