How can I get a customer's phone number from instant profile?

gkawin — Sun, 21 Sep 2025 12:41:17 GMT

Dear all,

I am trying to obtain the customer's phone number using the Square Webhook API. I anticipate collecting the phone number after sending the receipt to their mobile phone.

Please don't misunderstand; I intend to use the number in order to send a cooking status via SMS. The issue is that I am unable to retrieve it due to Square's instant profile restrictions. However, I understand the importance of privacy. Still, I find it a bit too strict for my fellow applications. I would like to discuss with you how to obtain the customer's phone number after they enter it at the Kiosk or the POS.

Thank you for any responses in advance.

Re: How can I get a customer's phone number from instant profile?

Summer2024 — Thu, 12 Jun 2025 21:47:32 GMT

Hi, @gkawin !

Square intentionally restricts access to customer contact information to protect customer privacy and comply with data protection regulations. When a customer enters their phone number for a digital receipt, this doesn't automatically grant permission for other communications.

Compliant Solutions:

Recommended Approach: Explicit Opt-In

Add a checkbox or prompt during checkout asking: "Would you like to receive SMS updates about your order status?"
This can be implemented using Square's Custom Fields feature in your POS/Kiosk setup
When customers explicitly opt-in, you can legally collect and use their number

Alternative Solution: Separate Sign-Up Flow

Use Square's Loyalty API to store customer information with proper consent

Integration Points:

Orders API - to track orders
Customers API - to manage customer profiles
Loyalty API - to maintain customer relationships

I hope this helps!

thread Re: How can I get a customer's phone number from instant profile? in Hardware Setup & Troubleshooting

How can I get a customer's phone number from instant profile?

Re: How can I get a customer's phone number from instant profile?