---
title: "Request a display name change"
method: POST
path: "/api/profiles/{profile_id}/whatsapp/request_display_name_change"
tags: ["WhatsApp"]
---

# Request a display name change

`POST /api/profiles/{profile_id}/whatsapp/request_display_name_change`

## Request

- Base URL: `https://api.postproxy.dev`
- URL: `https://api.postproxy.dev/api/profiles/{profile_id}/whatsapp/request_display_name_change`
- Auth: HTTP bearer

Submits a new display name for Meta review. The outcome arrives as a placement.name_status_updated webhook.

## Query parameters

- `profile_group_id` string
- `phone_number_id` string, required
- `display_name` string, required

## Response `200`

The change request was submitted.

- WhatsAppDisplayNameResponse
  - `display_name` object: name, status, new_name_status (null when no change is pending), phone_number.
  - `placement_id` string

## Other responses

- `400`: Missing required parameters.
- `401`: Invalid, missing, or insufficient API key permissions.
- `404`: Resource does not exist or is not accessible.
- `422`: Validation failed.

---

[API](https://skmtc.dev/postproxy/apis/postproxy-social-media-api.md) - [All operations](https://skmtc.dev/postproxy/apis/postproxy-social-media-api/llms.txt) - [OpenAPI document](https://skmtc.dev/postproxy/apis/postproxy-social-media-api/revisions/d54482ac4ce7?raw)