Calendar Convert
Convert between calendar and contact formats (vCard, ICS, JSON).
POST
1 credit
/v1/convert/calendar
curl -X POST "https://convert.toolkitapi.io/v1/convert/calendar" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{"from_format": "vcard", "to_format": "json", "data": "BEGIN:VCARD\nVERSION:3.0\nFN:Alice Example\nEMAIL:[email protected]\nEND:VCARD"}'
import httpx
resp = httpx.post(
"https://convert.toolkitapi.io/v1/convert/calendar",
json={"from_format": "vcard", "to_format": "json", "data": "BEGIN:VCARD\nVERSION:3.0\nFN:Alice Example\nEMAIL:[email protected]\nEND:VCARD"},
)
print(resp.json())const resp = await fetch("https://convert.toolkitapi.io/v1/convert/calendar", {
method: "POST",
headers: {
"Content-Type": "application/json",
},
body: JSON.stringify({"from_format": "vcard", "to_format": "json", "data": "BEGIN:VCARD\nVERSION:3.0\nFN:Alice Example\nEMAIL:[email protected]\nEND:VCARD"}),
});
const data = await resp.json();
console.log(data);# See curl example
Response
200 OK
{
"result": [{"fn": "Alice Example", "email": "[email protected]"}],
"count": 1
}Try It Live
Live Demo
Response
Description
Convert between calendar and contact formats (vCard, ICS, JSON).
How to Use
1
1. POST a JSON body with `from_format`, `to_format`, and `data` (inline source).
2
2. Optionally set `calendar_name` for ICS output.
3
3. Read the structured `result` and `count` from the response.
About This Tool
The unified calendar/contact converter moves between `vcard` (`.vcf`), `ics` (iCalendar), and `json`. It's the building block behind the individual `vcard-to-json`, `json-to-vcard`, `ics-to-json`, and `json-to-ics` endpoints.
Use this when you want to normalize calendar and contact data across systems — CRMs, mail clients, and custom apps.
Why Use This Tool
- CRM import/export — Move contacts between CRMs that prefer different formats
- Calendar sync — Convert ICS feeds into JSON for custom scheduling UIs
- Contact migration — Bulk-convert `.vcf` address books to JSON
- Event publishing — Generate ICS files from JSON event data
Frequently Asked Questions
Which pairs are supported?
`vcard ↔ json` and `ics ↔ json`. Direct `vcard ↔ ics` is not supported — convert via JSON.
Which vCard / iCalendar versions?
vCard 3.0 and 4.0 are supported. iCalendar RFC 5545 compatible.
Are recurring events preserved?
Yes — `RRULE` fields round-trip between ICS and JSON.
Start using Calendar Convert now
Get your free API key and make your first request in under a minute.