Inventory Generate Snapshot

GraphQL API
1

Hello ShipHero Team,

I am using the inventory_generate_snapshot GraphQL mutation, and the mutation executes successfully.

However, I am consistently seeing that both snapshot_url and post_url are returned as null in the API response, even though the snapshot is generated correctly and the snapshot download URL is later delivered via email.

Mutation used:

mutation {
  inventory_generate_snapshot(
    data: {
      customer_account_id: "QWNjdDo5MDQ1Nw=="
      warehouse_id: "V2FyZWhvEyNTQ3NA=="
      notification_email: "ajay@gmail.com"
      updated_from: "2025-12-31T00:00:00Z"
    }
  ) {
    request_id
    snapshot {
      snapshot_url
      post_url
      status
      created_at
    }
  }
}

API Response :

{
  "snapshot": {
    "post_url": null,
    "post_url_pre_check": true,
    "snapshot_url": null,
    "status": "InventorySnapshotStatus.enqueued",
    "created_at": "2026-01-07T13:30:39+00:00"
  }
}

Why are snapshot_url and post_url returned as null in the API response even after the snapshot is successfully generated?

Note: Customer id, warehouse id are not the originial, it just sample values.

Thank you,
Ajay

2

Hi ajay,

The snapshot is not fully generated at the instant the generate request is sent and so doesn’t yet have a valid URL. The URL is generated once the snapshot is complete and in the response you can see that the status is still enqueued. Even if the email seems to arrive nearly instantly there is still some amount of time between the generate request response and the snapshot generating. You will need to retrieve the URL by using the inventory_snapshot query once the generation has been completed.

Thanks,

3

Got it @Nathan-Rhodes , Thanks!