post https://{region}.mixpanel.com/track#identity-create-alias
The $create_alias event payload is only useful for projects using the Original ID Merge system and the Legacy ID Management System; it has no functionality in the Simplified ID Merge system. Please review this section of our documentation for more information.
You can also use the import endpoint: https://api.mixpanel.com/import/
Mixpanel supports adding an alias to a distinct id. An alias is a new value that will be interpreted by Mixpanel as an existing value. That means that you can send messages to Mixpanel using the new value, and Mixpanel will continue to use the old value for calculating funnels and retention reports, or applying updates to user profiles.
Alias Criteria:
Required Event Object attributes
| Event Object property | Type | Description |
|---|---|---|
| event | String required | value must be: $create_alias |
| properties | Object required | |
| properties.distinct_id | String required | A distinct_id to be merged with the alias. |
| properties.alias | String required | A new distinct_id to be merged with the original distinct_id. Each alias can only map to one distinct_id. |
| properties.token | String required | The project token. |