vCard API — Send Contact Cards via iMessage

Send digital contact cards that recipients save with one tap. Your name and photo appear on every future message — building trust and boosting response rates.

Why Send vCards?

When someone receives a message from an unknown number, they're skeptical. When they receive a message from a saved contact with a name and photo, they engage. vCards bridge that gap.

Send a vCard as your first message, and the recipient can save your contact information with a single tap. Every subsequent message from your number will show your name and photo instead of a random phone number. This alone can increase response rates by 20-40%.

How It Works

Send a vCard via the API

curl -X POST https://api.sendblue.co/api/send-message \
  -H "sb-api-key-id: YOUR_API_KEY" \
  -H "sb-api-secret-key: YOUR_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "number": "+19998887777",
    "content": "Here is my contact info. Save it so you always know it is me!",
    "media_url": "https://example.com/contacts/john-doe.vcf",
    "status_callback": "https://yourapp.com/webhook/status"
  }'

The media_url points to a publicly hosted VCF file. Sendblue delivers it as a native iMessage contact card that the recipient can tap to save.

Key Capabilities

One-Tap Save

Recipients tap the contact card and save it to their phone. No manual entry, no typing errors. Your info is in their contacts instantly.

Custom Fields

Include name, phone, email, company, title, address, website, and photo. Fully customize the VCF to match your brand.

Caller ID

Once saved, your name appears on calls and messages. No more "unknown number" — the recipient knows exactly who's reaching out.

Programmatic Generation

Generate VCF files dynamically for each rep, agent, or team member. Personalize contact cards at scale.

Use Cases

Sales Introductions

Lead with a vCard. New prospects save your info and see your name on every follow-up. First impressions that stick.

Service Providers

Doctors, attorneys, realtors — send your contact card so clients always have your number saved. Reduces missed calls and builds professional trust.

Support Teams

Send a support team vCard so customers save the support number. Future support messages show your company name, not a random number.

vCards as Part of Your Messaging Strategy

The best results come from combining vCards with other Sendblue features. Send the vCard first, follow up with typing indicators and a personalized message, then track engagement with read receipts. Attach images or documents alongside the vCard for rich introductions.

Use number lookup to verify iMessage support before sending, and process responses through webhooks. Access everything via the Sendblue API or CLI.

Build trust with contact cards

Send vCards that recipients actually save. Free sandbox, no credit card required.

Get API Access

Frequently Asked Questions

What is a vCard?

A vCard (VCF file) is a digital contact card that contains name, phone number, email, company, and other contact information. When sent via iMessage, the recipient can save it to their contacts with a single tap.

How do I send a vCard via Sendblue?

Host your VCF file at a public URL and pass it as the media_url parameter in your send-message API call. Sendblue delivers it as a native iMessage contact card attachment.

Why do vCards increase response rates?

When a contact saves your vCard, your name and photo appear on future messages instead of an unknown number. This builds trust and recognition, making recipients more likely to read and respond to your messages.

Can I customize what fields appear in the vCard?

Yes. VCF files are fully customizable. Include any combination of name, phone, email, company, title, address, website, and photo. Generate the VCF file programmatically to personalize it per recipient or use case.