# My Customer Profile

The My Customer Profile API creates and provides access to a Customer profile scoped to a specific [Customer](https://docs.commercetools.com/api/projects/customers.md).

The API requires an access token from the [password flow](https://docs.commercetools.com/api/authorization.md#password-flow) or [anonymous session flow](https://docs.commercetools.com/api/authorization.md#tokens-for-anonymous-sessions).

The My Customer Profile API can also be used to [create (sign up) a Customer](https://docs.commercetools.com/api/projects/me-profile.md#create-sign-up-my-customer) from an [anonymous session](https://docs.commercetools.com/api/authorization.md#tokens-for-anonymous-sessions), or [merge (sign in)](https://docs.commercetools.com/api/projects/me-profile.md#authenticate-sign-in-my-customer) an anonymous session to an existing account.

The API intentionally provides access to a limited subset of fields on [Customer](https://docs.commercetools.com/api/projects/customers.md) to provide extra security in scenarios when the client application must communicate directly with the API on behalf of a customer, such as commerce in a mobile application. If you need to modify a field available on the [Customer](https://docs.commercetools.com/api/projects/customers.md) resource, do it from a trusted, server-side application.

Customer Group, customer number, external ID, and `ExternalAuth` [authentication mode](https://docs.commercetools.com/api/projects/customers.md#authenticationmode) cannot be set with this API.

## Representations

Representations are JSON objects submitted or received as payload to API requests or responses. Responses are similar to the responses returned on the [Customers](https://docs.commercetools.com/api/projects/customers.md) API, but requests may differ.

#### MyCustomerDraft

See API type definition [MyCustomerDraft](https://docs.commercetools.com/api/projects/me-profile.md?urn=ctp%3Aapi%3Atype%3AMyCustomerDraft).

#### MyCustomerSignin

See API type definition [MyCustomerSignin](https://docs.commercetools.com/api/projects/me-profile.md?urn=ctp%3Aapi%3Atype%3AMyCustomerSignin).

#### MyCustomerChangePassword

See API type definition [MyCustomerChangePassword](https://docs.commercetools.com/api/projects/me-profile.md?urn=ctp%3Aapi%3Atype%3AMyCustomerChangePassword).

#### MyCustomerResetPassword

See API type definition [MyCustomerResetPassword](https://docs.commercetools.com/api/projects/me-profile.md?urn=ctp%3Aapi%3Atype%3AMyCustomerResetPassword).

#### MyCustomerEmailVerify

See API type definition [MyCustomerEmailVerify](https://docs.commercetools.com/api/projects/me-profile.md?urn=ctp%3Aapi%3Atype%3AMyCustomerEmailVerify).

## Get My Customer

See API endpoint definition [GET /\{projectKey}/me](https://docs.commercetools.com/api/projects/me-profile.md?urn=ctp%3Aapi%3Aendpoint%3A%2F%7BprojectKey%7D%2Fme%3AGET).

## Get My Customer in Store 

See API endpoint definition [GET /\{projectKey}/in-store/key=\{storeKey}/me](https://docs.commercetools.com/api/projects/me-profile.md?urn=ctp%3Aapi%3Aendpoint%3A%2F%7BprojectKey%7D%2Fin-store%2Fkey%3D%7BstoreKey%7D%2Fme%3AGET).

## Create (sign up) My Customer

When used with an access token obtained by an [anonymous session flow](https://docs.commercetools.com/api/authorization.md#tokens-for-anonymous-sessions), all Orders and Carts belonging to the `anonymousId` are assigned to the newly created Customer.

See API endpoint definition [POST /\{projectKey}/me/signup](https://docs.commercetools.com/api/projects/me-profile.md?urn=ctp%3Aapi%3Aendpoint%3A%2F%7BprojectKey%7D%2Fme%2Fsignup%3APOST).

## Create (sign up) My Customer in Store 

When used with an access token obtained by an [anonymous session flow](https://docs.commercetools.com/api/authorization.md#tokens-for-anonymous-sessions), all Orders and Carts belonging to the `anonymousId` are assigned to the newly created Customer.

See API endpoint definition [POST /\{projectKey}/in-store/key=\{storeKey}/me/signup](https://docs.commercetools.com/api/projects/me-profile.md?urn=ctp%3Aapi%3Aendpoint%3A%2F%7BprojectKey%7D%2Fin-store%2Fkey%3D%7BstoreKey%7D%2Fme%2Fsignup%3APOST).

## Authenticate (sign in) My Customer

When used with an access token obtained by an [anonymous session flow](https://docs.commercetools.com/api/authorization.md#tokens-for-anonymous-sessions), all Orders and Carts belonging to the `anonymousId` are assigned to the newly created Customer.

See API endpoint definition [POST /\{projectKey}/me/login](https://docs.commercetools.com/api/projects/me-profile.md?urn=ctp%3Aapi%3Aendpoint%3A%2F%7BprojectKey%7D%2Fme%2Flogin%3APOST).

## Authenticate (sign in) My Customer in Store 

When used with an access token obtained by an [anonymous session flow](https://docs.commercetools.com/api/authorization.md#tokens-for-anonymous-sessions), all Orders and Carts belonging to the `anonymousId` are assigned to the newly created Customer.

See API endpoint definition [POST /\{projectKey}/in-store/key=\{storeKey}/me/login](https://docs.commercetools.com/api/projects/me-profile.md?urn=ctp%3Aapi%3Aendpoint%3A%2F%7BprojectKey%7D%2Fin-store%2Fkey%3D%7BstoreKey%7D%2Fme%2Flogin%3APOST).

## Update My Customer

See API endpoint definition [POST /\{projectKey}/me](https://docs.commercetools.com/api/projects/me-profile.md?urn=ctp%3Aapi%3Aendpoint%3A%2F%7BprojectKey%7D%2Fme%3APOST).

## Update My Customer in Store 

See API endpoint definition [POST /\{projectKey}/in-store/key=\{storeKey}/me](https://docs.commercetools.com/api/projects/me-profile.md?urn=ctp%3Aapi%3Aendpoint%3A%2F%7BprojectKey%7D%2Fin-store%2Fkey%3D%7BstoreKey%7D%2Fme%3APOST).

## Update actions

#### Change Email

See API type definition [MyCustomerChangeEmailAction](https://docs.commercetools.com/api/projects/me-profile.md?urn=ctp%3Aapi%3Atype%3AMyCustomerChangeEmailAction).

#### Set First Name

See API type definition [MyCustomerSetFirstNameAction](https://docs.commercetools.com/api/projects/me-profile.md?urn=ctp%3Aapi%3Atype%3AMyCustomerSetFirstNameAction).

#### Set Last Name

See API type definition [MyCustomerSetLastNameAction](https://docs.commercetools.com/api/projects/me-profile.md?urn=ctp%3Aapi%3Atype%3AMyCustomerSetLastNameAction).

#### Set Middle Name

See API type definition [MyCustomerSetMiddleNameAction](https://docs.commercetools.com/api/projects/me-profile.md?urn=ctp%3Aapi%3Atype%3AMyCustomerSetMiddleNameAction).

#### Set Title

See API type definition [MyCustomerSetTitleAction](https://docs.commercetools.com/api/projects/me-profile.md?urn=ctp%3Aapi%3Atype%3AMyCustomerSetTitleAction).

#### Set Salutation

See API type definition [MyCustomerSetSalutationAction](https://docs.commercetools.com/api/projects/me-profile.md?urn=ctp%3Aapi%3Atype%3AMyCustomerSetSalutationAction).

#### Add Address

See API type definition [MyCustomerAddAddressAction](https://docs.commercetools.com/api/projects/me-profile.md?urn=ctp%3Aapi%3Atype%3AMyCustomerAddAddressAction).

#### Change Address

See API type definition [MyCustomerChangeAddressAction](https://docs.commercetools.com/api/projects/me-profile.md?urn=ctp%3Aapi%3Atype%3AMyCustomerChangeAddressAction).

#### Remove Address

See API type definition [MyCustomerRemoveAddressAction](https://docs.commercetools.com/api/projects/me-profile.md?urn=ctp%3Aapi%3Atype%3AMyCustomerRemoveAddressAction).

#### Set Default Shipping Address

See API type definition [MyCustomerSetDefaultShippingAddressAction](https://docs.commercetools.com/api/projects/me-profile.md?urn=ctp%3Aapi%3Atype%3AMyCustomerSetDefaultShippingAddressAction).

#### Add Shipping Address ID

See API type definition [MyCustomerAddShippingAddressIdAction](https://docs.commercetools.com/api/projects/me-profile.md?urn=ctp%3Aapi%3Atype%3AMyCustomerAddShippingAddressIdAction).

#### Remove Shipping Address ID

See API type definition [MyCustomerRemoveShippingAddressIdAction](https://docs.commercetools.com/api/projects/me-profile.md?urn=ctp%3Aapi%3Atype%3AMyCustomerRemoveShippingAddressIdAction).

#### Set Default Billing Address

See API type definition [MyCustomerSetDefaultBillingAddressAction](https://docs.commercetools.com/api/projects/me-profile.md?urn=ctp%3Aapi%3Atype%3AMyCustomerSetDefaultBillingAddressAction).

#### Add Billing Address ID

See API type definition [MyCustomerAddBillingAddressIdAction](https://docs.commercetools.com/api/projects/me-profile.md?urn=ctp%3Aapi%3Atype%3AMyCustomerAddBillingAddressIdAction).

#### Remove Billing Address ID

See API type definition [MyCustomerRemoveBillingAddressIdAction](https://docs.commercetools.com/api/projects/me-profile.md?urn=ctp%3Aapi%3Atype%3AMyCustomerRemoveBillingAddressIdAction).

#### Set Company Name

See API type definition [MyCustomerSetCompanyNameAction](https://docs.commercetools.com/api/projects/me-profile.md?urn=ctp%3Aapi%3Atype%3AMyCustomerSetCompanyNameAction).

#### Set Date of Birth

See API type definition [MyCustomerSetDateOfBirthAction](https://docs.commercetools.com/api/projects/me-profile.md?urn=ctp%3Aapi%3Atype%3AMyCustomerSetDateOfBirthAction).

#### Set Vat ID

See API type definition [MyCustomerSetVatIdAction](https://docs.commercetools.com/api/projects/me-profile.md?urn=ctp%3Aapi%3Atype%3AMyCustomerSetVatIdAction).

#### Set Custom Type

See API type definition [MyCustomerSetCustomTypeAction](https://docs.commercetools.com/api/projects/me-profile.md?urn=ctp%3Aapi%3Atype%3AMyCustomerSetCustomTypeAction).

#### Set CustomField

See API type definition [MyCustomerSetCustomFieldAction](https://docs.commercetools.com/api/projects/me-profile.md?urn=ctp%3Aapi%3Atype%3AMyCustomerSetCustomFieldAction).

#### Set Locale

See API type definition [MyCustomerSetLocaleAction](https://docs.commercetools.com/api/projects/me-profile.md?urn=ctp%3Aapi%3Atype%3AMyCustomerSetLocaleAction).

## Change password of My Customer

See API endpoint definition [POST /\{projectKey}/me/password](https://docs.commercetools.com/api/projects/me-profile.md?urn=ctp%3Aapi%3Aendpoint%3A%2F%7BprojectKey%7D%2Fme%2Fpassword%3APOST).

## Change password of My Customer in Store 

See API endpoint definition [POST /\{projectKey}/in-store/key=\{storeKey}/me/password](https://docs.commercetools.com/api/projects/me-profile.md?urn=ctp%3Aapi%3Aendpoint%3A%2F%7BprojectKey%7D%2Fin-store%2Fkey%3D%7BstoreKey%7D%2Fme%2Fpassword%3APOST).

## Reset password of My Customer

See API endpoint definition [POST /\{projectKey}/me/password/reset](https://docs.commercetools.com/api/projects/me-profile.md?urn=ctp%3Aapi%3Aendpoint%3A%2F%7BprojectKey%7D%2Fme%2Fpassword%2Freset%3APOST).

## Reset password of My Customer in Store 

See API endpoint definition [POST /\{projectKey}/in-store/key=\{storeKey}/me/password/reset](https://docs.commercetools.com/api/projects/me-profile.md?urn=ctp%3Aapi%3Aendpoint%3A%2F%7BprojectKey%7D%2Fin-store%2Fkey%3D%7BstoreKey%7D%2Fme%2Fpassword%2Freset%3APOST).

## Verify email of My Customer

See API endpoint definition [POST /\{projectKey}/me/email/confirm](https://docs.commercetools.com/api/projects/me-profile.md?urn=ctp%3Aapi%3Aendpoint%3A%2F%7BprojectKey%7D%2Fme%2Femail%2Fconfirm%3APOST).

## Verify email of My Customer in Store 

See API endpoint definition [POST /\{projectKey}/in-store/key=\{storeKey}/me/email/confirm](https://docs.commercetools.com/api/projects/me-profile.md?urn=ctp%3Aapi%3Aendpoint%3A%2F%7BprojectKey%7D%2Fin-store%2Fkey%3D%7BstoreKey%7D%2Fme%2Femail%2Fconfirm%3APOST).

## Delete My Customer

See API endpoint definition [DELETE /\{projectKey}/me](https://docs.commercetools.com/api/projects/me-profile.md?urn=ctp%3Aapi%3Aendpoint%3A%2F%7BprojectKey%7D%2Fme%3ADELETE).

## Delete My Customer in Store 

See API endpoint definition [DELETE /\{projectKey}/in-store/key=\{storeKey}/me](https://docs.commercetools.com/api/projects/me-profile.md?urn=ctp%3Aapi%3Aendpoint%3A%2F%7BprojectKey%7D%2Fin-store%2Fkey%3D%7BstoreKey%7D%2Fme%3ADELETE).

## Related pages

- [Section overview page](https://docs.commercetools.com/api.md)
- [Previous page: Overview](https://docs.commercetools.com/api/me-endpoints-overview.md)
- [Next page: My Business Units](https://docs.commercetools.com/api/projects/me-business-units.md)