Skip to main content

vCard QR Code

Create a QR code that saves contact information to the user's phone.

Type Identifier

type: "vCard"

Fields

FieldTypeRequiredDescription
typestringRequiredMust be "vCard"
first_namestringRequiredFirst name
last_namestringOptionalLast name
phonestringOptionalPrimary phone number
phone_altstringOptionalAlternative phone number
emailstringOptionalEmail address
websitestringOptionalWebsite URL
companystringOptionalCompany name
job_titlestringOptionalJob title or position
notestringOptionalAdditional notes
address.streetstringOptionalStreet address
address.citystringOptionalCity
address.statestringOptionalState or province
address.postal_codestringOptionalPostal / ZIP code
address.countrystringOptionalCountry
linksarrayOptionalAdditional links: [{ "label": "...", "url": "..." }]

Use Cases

  • Business cards — Replace or supplement printed cards
  • Name badges — Quick contact sharing at events
  • Email signatures — Add a QR code to your signature
  • Networking — Easy contact exchange at conferences

Content Schema

{
"type": "vCard",
"first_name": "John",
"last_name": "Doe",
"phone": "+1234567890",
"email": "john@example.com",
"website": "https://johndoe.com",
"company": "Acme Inc",
"job_title": "Software Engineer",
"address": {
"street": "123 Main St",
"city": "New York",
"state": "NY",
"postal_code": "10001",
"country": "USA"
}
}

Example Request

curl -X POST "https://integration-api.qr-build.com/qr-codes" \
-H "X-API-Key: qrb_live_your_api_key_here" \
-H "Content-Type: application/json" \
-d '{
"name": "My Business Card",
"type": "vCard",
"content": {
"type": "vCard",
"first_name": "John",
"last_name": "Doe",
"phone": "+1234567890",
"email": "john@acme.com",
"company": "Acme Inc",
"job_title": "CEO",
"links": [
{ "label": "LinkedIn", "url": "https://linkedin.com/in/johndoe" }
]
}
}'