Create Additional Alias

The Create Additional Alias endpoint enables you to create a new additional Alias associated with the main alias value.

You can create an additional alias by making a POST request to the Create Additional Alias endpoint, where aliasId is the identifier of the existing alias. For example:

{{base-url}}/ads/api/v1/aliases/{aliasId}/additionalAlias

The POST body should include the details of the payment type and the alias info.

{
  "type": "PHONE",
  "value": "1231231234"
}

If successful, a 200 response is returned.

{
  "status": "success",
  "response": {
    "trackingId": "alias#-64111a56-20250602063331",
    "id": "e336c8c8-2945-4be3-af3e-951ec2d01219"
  }
}

📘
More Information

To view this endpoint in the API Explorer, see Create Additional Alias.

To view descriptions for this endpoint, see Create Additional Alias - Field Descriptions.