HubSpot · Schema

BatchResponse

Response from batch operations

AnalyticsCommerceContentCRMCustomer ServiceEmail MarketingMarketingMarketing AutomationOperationsSales

Properties

Name Type Description
status string Current status of the batch operation
results array Successfully processed posts
requestedAt string ISO 8601 timestamp when the batch was requested
startedAt string ISO 8601 timestamp when processing started
completedAt string ISO 8601 timestamp when processing completed
links object Related links
View JSON Schema on GitHub

JSON Schema

hubspot-blog-posts-batch-response-schema.json Raw ↑
{
  "type": "object",
  "description": "Response from batch operations",
  "properties": {
    "status": {
      "type": "string",
      "description": "Current status of the batch operation",
      "example": "PENDING",
      "enum": [
        "PENDING",
        "PROCESSING",
        "CANCELED",
        "COMPLETE"
      ]
    },
    "results": {
      "type": "array",
      "description": "Successfully processed posts",
      "example": [
        {
          "id": "500123",
          "name": "Example Record",
          "slug": "example-value",
          "htmlTitle": "Example Record",
          "postBody": "This is an example description.",
          "postSummary": "example-value",
          "blogAuthorId": "500123",
          "authorName": "Example Record",
          "contentGroupId": "500123",
          "campaign": "example-value",
          "categoryId": 500123,
          "state": "DRAFT",
          "currentState": "active",
          "publishDate": "2025-03-15T14:30:00Z",
          "created": "2025-03-15T14:30:00Z",
          "updated": "2025-03-15T14:30:00Z",
          "archivedAt": "2025-03-15T14:30:00Z",
          "currentlyPublished": true,
          "domain": "example.hubspot.com",
          "featuredImage": "example-value",
          "featuredImageAltText": "example-value",
          "metaDescription": "This is an example description.",
          "headHtml": "example-value",
          "footerHtml": "example-value",
          "language": "en",
          "translatedFromId": "500123",
          "tagIds": [
            500123
          ],
          "useFeaturedImage": true,
          "url": "https://app.hubspot.com/contacts/12345",
          "abStatus": "master",
          "abTestId": "500123",
          "folderId": "500123"
        }
      ],
      "items": {
        "type": "object",
        "description": "Represents a blog post with all content and metadata",
        "properties": {
          "id": {
            "type": "string",
            "description": "Unique identifier for the blog post",
            "example": "500123"
          },
          "name": {
            "type": "string",
            "description": "Internal name of the blog post",
            "example": "Example Record"
          },
          "slug": {
            "type": "string",
            "description": "URL slug for the blog post",
            "example": "example-value"
          },
          "htmlTitle": {
            "type": "string",
            "description": "HTML title tag content",
            "example": "Example Record"
          },
          "postBody": {
            "type": "string",
            "description": "HTML content of the blog post body",
            "example": "This is an example description."
          },
          "postSummary": {
            "type": "string",
            "description": "Summary or excerpt of the blog post",
            "example": "example-value"
          },
          "blogAuthorId": {
            "type": "string",
            "description": "ID of the associated blog author",
            "example": "500123"
          },
          "authorName": {
            "type": "string",
            "description": "Display name of the author",
            "example": "Example Record"
          },
          "contentGroupId": {
            "type": "string",
            "description": "ID of the blog this post belongs to",
            "example": "500123"
          },
          "campaign": {
            "type": "string",
            "description": "Campaign GUID associated with the post",
            "example": "example-value"
          },
          "categoryId": {
            "type": "integer",
            "description": "Category ID for the post",
            "example": 500123
          },
          "state": {
            "type": "string",
            "description": "Current state of the blog post",
            "example": "DRAFT",
            "enum": [
              "DRAFT",
              "DRAFT_AB",
              "AUTOMATED",
              "PUBLISHED",
              "SCHEDULED",
              "AUTOMATED_DRAFT"
            ]
          },
          "currentState": {
            "type": "string",
            "description": "Current state description",
            "example": "active"
          },
          "publishDate": {
            "type": "string",
            "description": "ISO 8601 timestamp when the post was/will be published",
            "format": "date-time",
            "example": "2025-03-15T14:30:00Z"
          },
          "created": {
            "type": "string",
            "description": "ISO 8601 timestamp when the post was created",
            "format": "date-time",
            "example": "2025-03-15T14:30:00Z"
          },
          "updated": {
            "type": "string",
            "description": "ISO 8601 timestamp when the post was last updated",
            "format": "date-time",
            "example": "2025-03-15T14:30:00Z"
          },
          "archivedAt": {
            "type": "string",
            "description": "ISO 8601 timestamp when the post was archived",
            "format": "date-time",
            "example": "2025-03-15T14:30:00Z"
          },
          "currentlyPublished": {
            "type": "boolean",
            "description": "Whether the post is currently published",
            "example": true
          },
          "domain": {
            "type": "string",
            "description": "Domain where the post is published",
            "example": "example.hubspot.com"
          },
          "featuredImage": {
            "type": "string",
            "description": "URL of the featured image",
            "example": "example-value"
          },
          "featuredImageAltText": {
            "type": "string",
            "description": "Alt text for the featured image",
            "example": "example-value"
          },
          "metaDescription": {
            "type": "string",
            "description": "Meta description for SEO",
            "example": "This is an example description."
          },
          "headHtml": {
            "type": "string",
            "description": "Custom HTML for the head section",
            "example": "example-value"
          },
          "footerHtml": {
            "type": "string",
            "description": "Custom HTML for the footer section",
            "example": "example-value"
          },
          "language": {
            "type": "string",
            "description": "Language code of the blog post",
            "example": "en"
          },
          "translatedFromId": {
            "type": "string",
            "description": "ID of the original post this was translated from",
            "example": "500123"
          },
          "tagIds": {
            "type": "array",
            "description": "Array of tag IDs associated with the post",
            "example": [
              500123
            ],
            "items": {
              "type": "integer"
            }
          },
          "useFeaturedImage": {
            "type": "boolean",
            "description": "Whether to display the featured image",
            "example": true
          },
          "url": {
            "type": "string",
            "description": "Full URL of the published post",
            "format": "uri",
            "example": "https://app.hubspot.com/contacts/12345"
          },
          "abStatus": {
            "type": "string",
            "description": "A/B test status",
            "example": "master",
            "enum": [
              "master",
              "variant"
            ]
          },
          "abTestId": {
            "type": "string",
            "description": "A/B test ID if part of a test",
            "example": "500123"
          },
          "folderId": {
            "type": "string",
            "description": "ID of the folder containing the post",
            "example": "500123"
          }
        },
        "required": [
          "id",
          "name",
          "created",
          "updated"
        ]
      }
    },
    "requestedAt": {
      "type": "string",
      "description": "ISO 8601 timestamp when the batch was requested",
      "format": "date-time",
      "example": "2025-03-15T14:30:00Z"
    },
    "startedAt": {
      "type": "string",
      "description": "ISO 8601 timestamp when processing started",
      "format": "date-time",
      "example": "2025-03-15T14:30:00Z"
    },
    "completedAt": {
      "type": "string",
      "description": "ISO 8601 timestamp when processing completed",
      "format": "date-time",
      "example": "2025-03-15T14:30:00Z"
    },
    "links": {
      "type": "object",
      "description": "Related links",
      "example": {
        "key": "value"
      }
    }
  },
  "required": [
    "status",
    "results",
    "startedAt",
    "completedAt"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "BatchResponse"
}