---
title: "POST /v0.1/apps/{owner_name}/{app_name}/apple_mapping"
method: POST
path: "/v0.1/apps/{owner_name}/{app_name}/apple_mapping"
tags: ["distribute"]
---

# POST /v0.1/apps/{owner_name}/{app_name}/apple_mapping

`POST /v0.1/apps/{owner_name}/{app_name}/apple_mapping`

## Request

- Base URL: `https://api.appcenter.ms`
- URL: `https://api.appcenter.ms/v0.1/apps/{owner_name}/{app_name}/apple_mapping`
- Auth: API key in header `X-API-Token`
- TypeScript: <https://skmtc.dev/appcenter/apis/app-center-client/docs/v0.1/apps/:owner_name/:app_name/apple_mapping/post.ts> (a function with typed inputs; its response is checked against the schema)

Create a mapping for an existing app in apple store for the specified application.

## Path parameters

- `owner_name` string, required
- `app_name` string, required

## Request body

- object: Apple Mapping Request Type
  - `service_connection_id` string, required: Id for the shared service connection. In case of Apple AppStore, this connection will be used to create and connect to the Apple AppStore in Mobile Center.
  - `apple_id` string: ID of the apple application in apple store, takes precedence over bundle_identifier when both are provided
  - `bundle_identifier` string: Bundle Identifier of the apple package
  - `team_identifier` string, required: ID of the Team associated with the app in apple store

## Response `201`

Success

- object: Apple Mapping Request Type
  - `app_id` string: ID of the apple application in Mobile Center
  - `service_connection_id` string: Id for the shared service connection. In case of Apple AppStore, this connection will be used to create and connect to the Apple AppStore in Mobile Center.
  - `apple_id` string: ID of the apple application in apple store
  - `team_identifier` string: ID of the Team associated with the app in apple store

## Other responses

- `default`: Error

---

[API](https://skmtc.dev/appcenter/apis/app-center-client.md) - [All operations](https://skmtc.dev/appcenter/apis/app-center-client/llms.txt) - [OpenAPI document](https://skmtc.dev/appcenter/apis/app-center-client/revisions/4e9226ab8f35?raw)