WebhookJob

Represents incoming webhook transaction with comprehensive data preservation. New ELT-based approach ensures no data loss and supports partial success states.

type WebhookJob implements Node, Job {
  id: ID!
  status: JobStatusEnum!
  createdAt: DateTime!
  updatedAt: DateTime!
  message: String
  source: String
  fieldMappingVersion: String
  isPartialSuccess: Boolean!
  marketplaceEntityLink: String @deprecated
  vendorEntityLink: String @deprecated
  entitiesCreated: [String!]
  type: GenericWebhookTransactionType
  sourceTopic: String
  sourceType: String
  seller: Seller
  tenant: Tenant
  body: JSONString
  requestMeta: JSONString
  rawPayload: JSONString
  mappedData: JSONString
  unmappedFields: JSONString!
  validationErrors: JSONString!
  processingMetadata: JSONString!
  entitiesFailed: JSONString
}

Show more ↓

Fields

WebhookJob.id ● ID! non-null scalar

The Globally Unique ID of this object

WebhookJob.status ● JobStatusEnum! non-null enum

Job status.

WebhookJob.createdAt ● DateTime! non-null scalar

Created date time of job in ISO 8601 format.

WebhookJob.updatedAt ● DateTime! non-null scalar

Date time of job last update in ISO 8601 format.

WebhookJob.message ● String scalar

Job message.

WebhookJob.source ● String scalar

Webhook source (e.g., 'shopify')

WebhookJob.fieldMappingVersion ● String scalar

Version of field mapping configuration used (for schema evolution tracking)

WebhookJob.isPartialSuccess ● Boolean! non-null scalar

True if webhook processing succeeded for some but not all entities

WebhookJob.marketplaceEntityLink ● String deprecated scalar

DEPRECATED

This will be removed on September 26, 2025

Link to marketplace entity (e.g., /products/123). DEPRECATED: Use entities_created instead.

WebhookJob.vendorEntityLink ● String deprecated scalar

DEPRECATED

This will be removed on September 26, 2025

Link to vendor entity. DEPRECATED: No longer used.

WebhookJob.entitiesCreated ● [String!] list scalar

List of successfully created entities. Format: ['product:123', 'variant:456', 'image:789']. Use this to track what was created from the webhook.

WebhookJob.type ● GenericWebhookTransactionType enum

Normalized event type

WebhookJob.sourceTopic ● String scalar

Webhook source topic (normalized event type)

WebhookJob.sourceType ● String scalar

Webhook source type (e.g., 'shopify')

WebhookJob.seller ● Seller object

Seller associated with this webhook

WebhookJob.tenant ● Tenant object

Tenant this webhook belongs to

WebhookJob.body ● JSONString scalar

Request body payload

WebhookJob.requestMeta ● JSONString scalar

Request metadata (headers, etc.)

WebhookJob.rawPayload ● JSONString scalar

Complete raw webhook payload

WebhookJob.mappedData ● JSONString scalar

Data after field mapping transformation

WebhookJob.unmappedFields ● JSONString! non-null scalar

Fields that don't have mappings

WebhookJob.validationErrors ● JSONString! non-null scalar

Per-field validation errors

WebhookJob.processingMetadata ● JSONString! non-null scalar

Processing context and metadata

WebhookJob.entitiesFailed ● JSONString scalar

Entities that failed creation

Interfaces

Node interface

An object with a Globally Unique ID

Job interface

An async job that tracks status and progress.

Member Of

WebhookJobCountableEdge object