How to upload a VCF and get a URL
Contact exports often need to cross a boundary between a CRM, a form, an email, and a phone. FilePost gives the vCard file a public URL that can be shared or passed to an import step without adding a storage service.
Send the VCF as a normal file upload and set text/vcard as the content type when you want consumers to identify it correctly. FilePost keeps the file bytes intact; it does not parse or merge contacts.
Upload vcf files with FilePost
Use the authenticated FilePost upload API for vcf files. The endpoint returns a JSON object containing the public URL, file ID, size, content type, and filename mode.
curl -X POST https://upload.filepost.dev/v1/upload \
-H "X-API-Key: YOUR_API_KEY" \
-F "file=@contact.vcf" \
-F "content_type=text/vcard"Example response
{
"url": "https://cdn.filepost.dev/file/…",
"file_id": "a1b2c3d4e5f6",
"name": "contact.vcf",
"size": 84210,
"content_type": "text/vcard"
}What to do with the returned URL
Share the URL or pass it to the application that needs to download and import the contact file.
<a href="https://cdn.filepost.dev/file/…">Import contact</a>Good uses for vcf to URL
- Contact export and import links
- CRM and form handoffs
- vCard files in automation workflows
Know the boundary
FilePost does not validate, deduplicate, enrich, or merge contact records. Treat the public URL as a delivery link and apply privacy controls appropriate to the data.
For the complete request and response contract, see the FilePost API documentation. You can also test the flow with the interactive upload on the homepage.