External IDs provide a powerful way to synchronize resources between your system and our API. They serve as your unique identifier for resources, with a maximum length of 180 characters, preventing duplicate resource creation. Once you assign an external ID to a resource, that ID becomes immutable and enables you to maintain referential integrity between your database and ours. This feature is particularly valuable for system synchronization, as you can use your existing internal IDs, UUIDs, or any string format that makes sense for your system.
External IDs do not replace idempotency keys—they serve different purposes and work together. While external IDs help you reference and identify resources across systems using your own identifiers, idempotency keys ensure that duplicate API requests don't create unintended side effects. The interaction and behavior of idempotency keys remains unchanged when using external IDs.