Contact cards

Contact cards let you set a business name and icon on your iMessage number so recipients see your brand instead of a raw phone number. Contact cards require an eligible iMessage line. Unsupported numbers return 422; contact support if your line needs this feature.

Setting a contact card

Use the PUT /v1/numbers/{id}/contact-card endpoint to create or update your card.

Things to know

• It shows up for recipients who don’t already have your number saved as a contact
• If you’re testing with someone who already has a thread with that number, they may need to delete the conversation and receive a new message to see it refresh
• It can take a few minutes to propagate after setting it