younifyd
Menu

Get /crm/v3/exports/export/async/tasks/{task Id}/status Get Status

Get Status of Export Including URL to Download

GET/crm/v3/exports/export/async/tasks/{taskId}/status

Use it in a workflow

  1. Add a step and choose the HubSpot connector.
  2. Pick the Get /crm/v3/exports/export/async/tasks/{task Id}/status Get Status action (under Exports).
  3. Fill in the fields below, then reference the result from later steps as {{getCrmV3ExportsExportAsyncTasksTaskIdStatusGetStatus.response.data}}.

Request

Path parameters

taskIdinteger (int64)required

Response

Returns 200 with an object. Read it in later steps with {{getCrmV3ExportsExportAsyncTasksTaskIdStatusGetStatus.response.data.<field>}}.

completedAtstring (date-time)

The timestamp when the export was completed, in ISO 8601 format.

errorsarray<object>
categorystringrequired

The main category of the error.

contextobjectrequired

Context about the error condition

errorsarray<object>required5 fields

The detailed error objects.

idstring

A unique ID for the error instance.

linksobjectrequired

URLs linking to documentation or resources associated with the error.

messagestringrequired

A human readable message describing the error along with remediation steps where appropriate

statusstringrequired

The HTTP status code associated with the error.

subCategoryobject

A specific category that contains more specific detail about the error

linksobject

A collection of related links associated with the export.

numErrorsinteger (int32)

The number of errors encountered during the export process.

requestedAtstring (date-time)

The timestamp when the export request was made, in ISO 8601 format.

resultstring

The URL of the resulting file if the export status is COMPLETE.

startedAtstring (date-time)

The timestamp when the export process started, in ISO 8601 format.

statusstring

The current status of the export, which can be PENDING, PROCESSING, COMPLETE or CANCELED.

One ofCANCELEDCOMPLETEPENDINGPROCESSING

json
{
  "completedAt": "2025-01-01T00:00:00Z",
  "startedAt": "2025-01-01T00:00:00Z",
  "status": "CANCELED",
  "errors": [
    {
      "category": "string",
      "context": {},
      "errors": [
        {
          "message": "string",
          "code": "string",
          "context": "{missingScopes=[scope1, scope2]}",
          "in": "string",
          "subCategory": "string"
        }
      ],
      "links": {},
      "message": "string",
      "status": "string",
      "id": "string",
      "subCategory": {}
    }
  ],
  "links": {},
  "numErrors": 0,
  "requestedAt": "2025-01-01T00:00:00Z",
  "result": "string"
}

Need more? See the HubSpot guide for connection setup and behaviour shared by every action.