# Amplitude User Mapping API

**Canonical:** https://apis.io/apis/amplitude/user-mapping-api/  
**Provider:** Amplitude — https://apis.io/providers/amplitude/  
**Base URL:** https://api2.amplitude.com  
**Documentation:** https://amplitude.com/docs/apis/analytics/user-mapping

Amplitude User Mapping API is one of 33 APIs that [Amplitude](https://apis.io/providers/amplitude/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Aliasing, Analytics, Identity, and User. The published artifact set on APIs.io includes API documentation and an OpenAPI specification.

The Amplitude User Mapping (Aliasing) API allows developers to merge users with different user IDs together in Amplitude. This is useful when a user initially interacts with a product anonymously and later creates an account, or when users have multiple identifiers across different systems. The API maps these distinct identities into a single unified user profile to ensure accurate analytics and attribution.

## Machine-readable artifacts (2)

- **Documentation** — https://amplitude.com/docs/apis/analytics/user-mapping
- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/amplitude/refs/heads/main/openapi/amplitude-user-mapping-api-openapi.yml

## Other Amplitude APIs (12)

- [Amplitude Batch Event Upload API](https://apis.io/apis/amplitude/batch-event-upload-api/)
- [Amplitude Identify API](https://apis.io/apis/amplitude/identify-api/)
- [Amplitude Group Identify API](https://apis.io/apis/amplitude/group-identify-api/)
- [Amplitude Export API](https://apis.io/apis/amplitude/export-api/)
- [Amplitude Attribution API](https://apis.io/apis/amplitude/attribution-api/)
- [Amplitude Releases API](https://apis.io/apis/amplitude/releases-api/)
- [Amplitude Session Replay API](https://apis.io/apis/amplitude/session-replay-api/)
- [Amplitude User Privacy API](https://apis.io/apis/amplitude/user-privacy-api/)
- [Amplitude Webhooks and Cohort Sync](https://apis.io/apis/amplitude/webhooks-cohort-sync/)
- [Amplitude Annotations API](https://apis.io/apis/amplitude/amplitude-annotations-api/)
- [Amplitude Cohorts API](https://apis.io/apis/amplitude/amplitude-cohorts-api/)
- [Amplitude Data Access API](https://apis.io/apis/amplitude/amplitude-data-access-api/)

## Tags

Aliasing, Analytics, Identity, User

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/amplitude/user-mapping-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/amplitude/.