Skip to main content

Bulk Publish

When you need to update or synchronize many records at once, you can define a single bulk publish request that handles them together. It’s useful when you’re seeding new data, correcting existing records, or re-running integrations after configuration changes. Data flows outbound only - from SyncHive to connected systems.

Accessing Bulk Publish​

  1. Go to Integrate ⮕ Integrations and select the integration whose records you want to trigger in bulk.
  2. Open the Bulk Publish tab. If you’ve already created some, a list of your bulk publish requests will appear.

Each request shows the following details:

Shape - The data structure associated with the publish.
Name – The name you gave the request.
Filter – The type of filter used (Hive IDs, External IDs).
Last Run – The date and time the request was last executed.
State – The current status (Stopped, Completed, Completed with Errors, or Error).
Counts – How many records were completed, sent, or failed.

Creating a Bulk Publish​

  1. Click New Bulk Publish.
  2. Select a Shape from the list of available shapes.

Note: Once you save the request, you won’t be able to change the shape.

  1. Enter a Name for the bulk publish.

Note: Both shape and name are required fields.

  1. Choose a Filter:
  • Hive IDs
  • External IDs
  1. Enter the corresponding IDs into the filter field.
  • You can’t mix Hive IDs and External IDs in the same request.
  • External IDs are specific to a single integration. If you have multiple integrations with external IDs , you’ll need to select one integration external ID per one bulk publish run.

Hive ID Validations​

When you save a bulk publish request with Hive IDs to filter the records, SyncHive validates those Hive IDs:

  • Length: Hive IDs must be exactly 12 characters long.
  • Allowed characters: Numbers 0–9 and uppercase letters A–F.
  • If any Hive IDs are invalid, saving the bulk publish request will fail, and you’ll see an error message showing how many IDs are invalid.
  • When you save a bulk publish request, SyncHive just checks that your Hive IDs are in the valid format, it doesn’t confirm that they actually exist. If any don’t, you’ll find out when the bulk publish executes.

Editing a Bulk Publish​

You can edit an existing bulk publish to:

  • Change the Name.
  • Modify the Filter setting (Hive IDs, External IDs or none).
  • Update the list of IDs.

You can’t change the shape once the bulk publish has been saved.

Running a Bulk Publish​

  1. From the main screen, find the bulk publish you want to run.
  2. Click the run icon
  3. SyncHive will display a confirmation message showing how many records will be published
  4. Confirm to continue.

Monitoring Results​

After running a bulk publish, check the results in the Bulk Publish list:

  • The State column shows whether it completed successfully, completed with errors, or failed.
  • The Counts column summarizes how many records were completed, sent, and failed.

You can also go to the Dashboard to monitor data flow activity and review detailed logs for each integration.

Managing Bulk Publish Requests​

You can view, edit, delete, or run saved bulk publish requests at any time.

Note: Each request is tied to a single integration and a single shape. You can create multiple requests for the same integration, but each one operates independently.