Announcing upsert endpoints for custom objects!
We're rolling out our "upsert" functionality (external ID-based actions) via two new API endpoints, and an update to our jobs endpoint:
- Set object records by external ID allows you to submit a request entirely on just the
external_idfield to check whether the object record already exists, and if so, update the existing record. If the record does not exist, it creates a new record with the external ID.
- Delete object records by external ID allows you to delete records based on external IDs. This endpoint checks whether a custom object record exists with the request's external ID. If it does, it deletes the record. If not, nothing happens.
- Bulk update and delete records by external ID allows you to submit a request for multiple records to be updated/created or deleted based on external IDs by using the job endpoint action properties.
Who can use it?
These features are available to all active customers using custom objects. Follow the links above to learn more in the API docs.