Skip to main content
Even in bulk shipments, each card should be:
  • Individually packaged.
  • Labeled with its recipient mailing address.
  • Ready for easy redistribution by the bulk shipment recipient.
Shipping behavior:Cards grouped in a bulk shipment must be individually addressed and packaged, so they can be forwarded or handed out without repackaging.
Follow the steps below to set up and manage bulk card shipments.
1

Create a shipping group

To initiate a bulk shipment, first create a shipping group using the Create a bulk shipping group endpoint.This creates a unique bulkShippingGroupId that you will reference when creating cards to include in this shipment. Below, you can find an example request.
The response returns the group, including its id. Use that value as the bulkShippingGroupId when you create cards:
To check an address before creating the group, call POST /issuing/shipping-groups/validate-address with the address; the response returns isValid and a confidence level.
2

Create cards with the shipping group ID

When creating each card, include the bulkShippingGroupId in the request payload. All cards with the same ID will be grouped for shipment.

​
Example workflow

  1. Create a shipping group → Receive its id
  2. Create Card A with bulkShippingGroupId set to that id
  3. Create Card B with the same bulkShippingGroupId
Both cards will be shipped together in one bulk package.
Include shipping id when creating the card:You must include the bulkShippingGroupId at the time of card creation. It cannot be added or changed later.
3

Understand grouping rules and cutoff times

Cards are grouped into the same shipment only if they:
  • Share the same bulkShippingGroupId.
  • Are created before 12:00 PM EST, Monday through Friday.

​
Grouping timing example

Plan card creation time:To ensure cards are grouped correctly, plan card creation to complete before the 12:00 PM EST cutoff.

​
Common questions

​
How many cards can I include in a bulk shipping group?

A minimum of two cards is required for a shipment to qualify as a bulk group.

​
Can I change the shipping group after creating a card?

No. The bulkShippingGroupId must be set at the time of card creation and cannot be updated later.

​
What happens if I forget to set up a shipping group?

Cards without a bulkShippingGroupId will be shipped individually, not as part of a bulk group.

​
How are the cards packaged?

Each card is:
  • Individually sealed
  • Labeled with its specific recipient mailing address
  • Easy to redistribute by the bulk shipment recipient

​
Where can I find the shipping group ID?

The bulkShippingGroupId is returned in the response when you create a shipping group using the Create a bulk shipping group endpoint.