JSON to vCard
Generate a vCard (.vcf) file from JSON contacts.
POST
1 credit
/v1/convert/json-to-vcard
curl -X POST "https://convert.toolkitapi.io/v1/convert/json-to-vcard" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{"contacts": [{"fn": "Alice Example", "email": "[email protected]", "tel": "+1-555-0100"}]}'
import httpx
resp = httpx.post(
"https://convert.toolkitapi.io/v1/convert/json-to-vcard",
json={"contacts": [{"fn": "Alice Example", "email": "[email protected]", "tel": "+1-555-0100"}]},
)
print(resp.json())const resp = await fetch("https://convert.toolkitapi.io/v1/convert/json-to-vcard", {
method: "POST",
headers: {
"Content-Type": "application/json",
},
body: JSON.stringify({"contacts": [{"fn": "Alice Example", "email": "[email protected]", "tel": "+1-555-0100"}]}),
});
const data = await resp.json();
console.log(data);# See curl example
Response
200 OK
{
"vcard": "BEGIN:VCARD\nVERSION:3.0\nFN:Alice Example\nEMAIL:[email protected]\nTEL:+1-555-0100\nEND:VCARD\n",
"count": 1
}Description
Generate a vCard (.vcf) file from JSON contacts.
How to Use
1
1. POST a JSON body with `contacts` — an array of contact objects.
2
2. Read the `vcard` string and `count` from the response.
About This Tool
Generates a vCard (`.vcf`) string from a JSON array of contact objects. Each contact becomes a `BEGIN:VCARD ... END:VCARD` block. Multi-value fields (emails, phones) are emitted as repeated lines.
Output conforms to vCard 3.0 by default.
Why Use This Tool
- Address-book exports — Produce `.vcf` for import into iOS/macOS/Outlook
- CRM outbound sync — Generate vCard from your CRM's JSON contacts
- Team contact sheets — Auto-generate `.vcf` from a JSON directory
- Backup — Snapshot contact JSON as distributable vCard
Frequently Asked Questions
Which vCard version is emitted?
vCard 3.0 by default — widest compatibility across mail clients.
Can I include photos?
Yes — include a `photo` field with base64-encoded image data; it's emitted as an inline `PHOTO` property.
What about custom fields?
Common extension fields (e.g. `note`, `url`, `bday`) are supported. Uncommon custom properties are ignored.
Start using JSON to vCard now
Get your free API key and make your first request in under a minute.