# Address Messages | Developer Documentation

<div id="bkmrk-address-messagesupda">## Address Messages

<div><span>Updated: Nov 7, 2025</span></div><div><div>This feature is only available for businesses based in India and their India customers.</div></div><div>Address messages give your users a simpler way to share the shipping address with the business on WhatsApp.</div><div>Address messages are interactive messages that contain the 4 main parts: `header`, `body`, `footer`, and `action`. Inside the action component business specifies the name “address_message” and relevant parameters.</div><div>Below table outlines the fields that are supported by the address message.</div><div><table><thead><tr><th><span>Field Name </span></th><th><span>Display Label </span></th><th><span>Input Type </span></th><th><span>Supported Countries </span></th><th><span>Limitations </span></th></tr></thead><tbody><tr><td><div><div>`name`</div></div></td><td><div><div>Name</div></div></td><td><div><div>text</div></div></td><td><div><div>India</div></div></td><td><div><div>None</div></div></td></tr><tr><td><div><div>`phone_number`</div></div></td><td><div><div>Phone Number</div></div></td><td><div><div>tel</div></div></td><td><div><div>India</div></div></td><td><div><div>Valid phone numbers only</div></div></td></tr><tr><td><div><div>`in_pin_code`</div></div></td><td><div><div>Pin Code</div></div></td><td><div><div>text</div></div></td><td><div><div>India</div></div></td><td><div><div>Max length: 6</div></div></td></tr><tr><td><div><div>`house_number`</div></div></td><td><div><div>Flat/House Number</div></div></td><td><div><div>text</div></div></td><td><div><div>India</div></div></td><td><div><div>None</div></div></td></tr><tr><td><div><div>`floor_number`</div></div></td><td><div><div>Floor Number</div></div></td><td><div><div>text</div></div></td><td><div><div>India</div></div></td><td><div><div>None</div></div></td></tr><tr><td><div><div>`tower_number`</div></div></td><td><div><div>Tower Number</div></div></td><td><div><div>text</div></div></td><td><div><div>India</div></div></td><td><div><div>None</div></div></td></tr><tr><td><div><div>`building_name`</div></div></td><td><div><div>Building/Apartment Name</div></div></td><td><div><div>text</div></div></td><td><div><div>India</div></div></td><td><div><div>None</div></div></td></tr><tr><td><div><div>`address`</div></div></td><td><div><div>Address</div></div></td><td><div><div>text</div></div></td><td><div><div>India</div></div></td><td><div><div>None</div></div></td></tr><tr><td><div><div>`landmark_area`</div></div></td><td><div><div>Landmark/Area</div></div></td><td><div><div>text</div></div></td><td><div><div>India</div></div></td><td><div><div>None</div></div></td></tr><tr><td><div><div>`city`</div></div></td><td><div><div>City</div></div></td><td><div><div>text</div></div></td><td><div><div>India</div></div></td><td><div><div>None</div></div></td></tr><tr><td><div><div>`state`</div></div></td><td><div><div>State</div></div></td><td><div><div>text</div></div></td><td><div><div>India</div></div></td><td><div><div>None</div></div></td></tr></tbody></table>

</div><div id="bkmrk-error-handling"><div id="bkmrk-error-handling-1"><div>### Error Handling

</div></div></div><div>If the area code of the phone number for the given country is not correct, businesses will be unable to request the address message from the recipient. For example, businesses will be unable to request an address message from a recipient that has the country as “India” but has a phone number with an area code of “65”.</div><div>Once the address message is sent, the business waits for the user to fill in the address and send it back. The user entered address is shared through the [webhook](/books/meta-whatsapp/page/managing-webhooks-developer-documentation) registered in the [setup process](/books/meta-whatsapp/page/managing-webhooks-developer-documentation).</div><div id="bkmrk-address-message-step"><div id="bkmrk-address-message-step-1"><div>### Address Message Steps

</div></div></div><div>The steps involved in an Address Message are the following:</div><span>Business sends an address message with the action name `address_message` to the user</span><span>User interacts with the message by clicking on the CTA, which brings up an Address Message screen. The user fills out their address and submits the form</span><span>After the address message form is submitted by the user, the partner receives a webhook notification, which contains the details of the address submitted by the user</span><div><div>**Sample India Address Message** </div></div><div><div>![Image](https://support2.chatarchitect.com/uploads/images/gallery/2026-04/embedded-image-pgj6gtg1.jpeg)![Image](https://support2.chatarchitect.com/uploads/images/gallery/2026-04/embedded-image-xjndcxdk.jpeg)![Image](https://support2.chatarchitect.com/uploads/images/gallery/2026-04/embedded-image-ugrcp5xq.jpeg)![Image](https://support2.chatarchitect.com/uploads/images/gallery/2026-04/embedded-image-vhkeilsr.jpeg)</div></div><div>The following sequence diagram shows a typical integration flow for an address message.</div><div><div>![Image](https://support2.chatarchitect.com/uploads/images/gallery/2026-04/embedded-image-ttw2u9y4.jpeg)</div></div><div id="bkmrk-check-your-response"><div id="bkmrk-check-your-response-1"><div>### Check Your Response

</div></div></div><div>A successful response includes a `messages` object with an ID for the newly created message.</div><div>An unsuccessful response contains an error message. See [Error and Status Codes](/documentation/business-messaging/whatsapp/support/error-codes) for more information.</div><div id="bkmrk-feature-not-supporte"><div id="bkmrk-feature-not-supporte-1"><div>### Feature Not Supported

</div></div></div><div>In the case where the client does not support `address_message`, messages are silently dropped and an error message is sent back to the business in a webhook. The webhook notification that would be sent back is shown below:</div></div>