Can I send events before the customer exists?

Last updated: September 13, 2024

Yes, if you set the external_customer_id field on the event body.

Attributing events to customers

Orb's event shape accepts one of two parameters for attributing events for customers:

  • customer_id - the Orb-generated identifier for the Customer

  • external_customer_id - an alias you define, usually set to an identifier native to your system.

We will reject events for customers with a customer_id that does not exist currently in Orb.

We will accept events with an external_customer_id , even if an Orb customer with that external_customer_id does not exist in our system yet. When the customer is retroactively created in Orb with that external_customer_id and an active subscription, any previously ingested events with that external_customer_id and overlapping the subscription's time range will automatically be attributed to that customer.