HubSpot · Schema

BlogAuthorCollection

Paginated collection of blog authors

AnalyticsCommerceContentCRMCustomer ServiceEmail MarketingMarketingMarketing AutomationOperationsSales

Properties

Name Type Description
total integer Total number of authors matching the query
results array Array of blog authors
paging object Pagination information for navigating result sets
View JSON Schema on GitHub

JSON Schema

hubspot-authors-blog-author-collection-schema.json Raw ↑
{
  "type": "object",
  "description": "Paginated collection of blog authors",
  "properties": {
    "total": {
      "type": "integer",
      "description": "Total number of authors matching the query",
      "example": 10
    },
    "results": {
      "type": "array",
      "description": "Array of blog authors",
      "example": [
        {
          "id": "500123",
          "name": "Example Record",
          "slug": "example-value",
          "email": "[email protected]",
          "bio": "example-value",
          "website": "https://app.hubspot.com/contacts/12345",
          "twitter": "example-value",
          "facebook": "example-value",
          "linkedin": "https://app.hubspot.com/contacts/12345",
          "avatar": "https://app.hubspot.com/contacts/12345",
          "language": "en",
          "translatedFromId": "500123",
          "created": "2025-03-15T14:30:00Z",
          "updated": "2025-03-15T14:30:00Z",
          "deletedAt": "2025-03-15T14:30:00Z"
        }
      ],
      "items": {
        "type": "object",
        "description": "Represents a blog author profile with biographical and social information",
        "properties": {
          "id": {
            "type": "string",
            "description": "Unique identifier for the blog author",
            "example": "500123"
          },
          "name": {
            "type": "string",
            "description": "Full display name of the author",
            "example": "Example Record"
          },
          "slug": {
            "type": "string",
            "description": "URL-friendly identifier for the author",
            "example": "example-value"
          },
          "email": {
            "type": "string",
            "description": "Author's email address",
            "format": "email",
            "example": "[email protected]"
          },
          "bio": {
            "type": "string",
            "description": "Author biography or description",
            "example": "example-value"
          },
          "website": {
            "type": "string",
            "description": "Author's personal website URL",
            "format": "uri",
            "example": "https://app.hubspot.com/contacts/12345"
          },
          "twitter": {
            "type": "string",
            "description": "Author's Twitter/X handle",
            "example": "example-value"
          },
          "facebook": {
            "type": "string",
            "description": "Author's Facebook profile URL",
            "example": "example-value"
          },
          "linkedin": {
            "type": "string",
            "description": "Author's LinkedIn profile URL",
            "example": "https://app.hubspot.com/contacts/12345"
          },
          "avatar": {
            "type": "string",
            "description": "URL to the author's avatar image",
            "format": "uri",
            "example": "https://app.hubspot.com/contacts/12345"
          },
          "language": {
            "type": "string",
            "description": "Language code for the author profile (e.g., en, es, fr)",
            "example": "en"
          },
          "translatedFromId": {
            "type": "string",
            "description": "ID of the original author this was translated from",
            "example": "500123"
          },
          "created": {
            "type": "string",
            "description": "ISO 8601 timestamp when the author was created",
            "format": "date-time",
            "example": "2025-03-15T14:30:00Z"
          },
          "updated": {
            "type": "string",
            "description": "ISO 8601 timestamp when the author was last updated",
            "format": "date-time",
            "example": "2025-03-15T14:30:00Z"
          },
          "deletedAt": {
            "type": "string",
            "description": "ISO 8601 timestamp when the author was archived",
            "format": "date-time",
            "example": "2025-03-15T14:30:00Z"
          }
        },
        "required": [
          "id",
          "name",
          "created",
          "updated"
        ]
      }
    },
    "paging": {
      "type": "object",
      "description": "Pagination information for navigating result sets",
      "properties": {
        "next": {
          "type": "object",
          "description": "Pagination cursor for retrieving the next page of results",
          "properties": {
            "after": {
              "type": "string",
              "description": "Cursor token for the next page",
              "example": "example-value"
            },
            "link": {
              "type": "string",
              "description": "API link to the next page of results",
              "example": "https://app.hubspot.com/contacts/12345"
            }
          }
        }
      }
    }
  },
  "required": [
    "total",
    "results"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "BlogAuthorCollection"
}