Dialb API Reference

Dialb

REST API · OAuth 2.0

Dialb API Reference

The Dialb API powers our Zapier integration. Connect via OAuth 2.0 and receive a webhook every time a visitor submits their details on one of your digital cards.

Connect via Zapier →OAuth 2.0 setup

OAuth 2.0

Dialb authenticates third-party apps using the standard OAuth 2.0 Authorization Code flow. The easiest way to use the API is through our Zapier integration, which handles the flow for you. If you are building your own client, here is what each step looks like.

1. Redirect the user to authorize

GET https://dialb.co/oauth/authorize
  ?client_id=<your_client_id>
  &redirect_uri=<your_redirect_uri>
  &response_type=code
  &state=<random_string>

2. Exchange the code for an access token

curl -X POST "https://app.dialb.co/api/oauth/token" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "grant_type=authorization_code" \
  -d "code=<code_from_redirect>" \
  -d "redirect_uri=<your_redirect_uri>" \
  -d "client_id=<your_client_id>" \
  -d "client_secret=<your_client_secret>"

Returns:

{
  "access_token": "eyJ0eXAiOiJKV1QiLCJhbGciOi…",
  "token_type": "bearer"
}

3. Call the API with the access token

Authorization: Bearer <access_token>

Need OAuth credentials? Custom OAuth clients are issued on request. Contact us at [email protected] if you need direct API access outside of Zapier.

Webhook Payload

When a visitor submits their details on one of your digital cards, Dialb sends a POST request to your subscribed callback URL with the following JSON body. The single supported event is new_contact.

{
  "id": 42,
  "full_name": "Jane Smith",
  "email": "[email protected]",
  "phone": "+1 555-000-0000",
  "job_title": "Product Manager",
  "note": "Interested in a demo.",
  "status": "new",
  "created_at": "2026-05-07T09:00:00+00:00"
}

Field reference

idinteger

Unique lead ID.

full_namestring

Name the visitor entered.

emailstring | null

Email the visitor entered.

phonestring | null

Phone number the visitor entered.

job_titlestring | null

Position the visitor entered.

notestring | null

Free-text message left by the visitor.

statusstring

Always "new" on the initial webhook.

created_atstring (ISO 8601)

When the lead was captured.

Respond with any 2xx status to acknowledge delivery. Reply with 410 Gone to have Dialb permanently unsubscribe the webhook (used by Zapier when a Zap is turned off).

Authentication

GET/me

Verify access token

▾

Webhooks

DELETE/webhooks/unsubscribe/{id}

Unsubscribe

▾

Leads

GET/contacts/recent

List recent leads

▾

All endpoints use HTTPS and return JSON. Unsuccessful requests return a 4xx status code with a {"status":"error","message":"..."} body. Rate limit: 1 000 requests / minute per access token.

Ready to Create Your Digital Business Card?

Join thousands of professionals and businesses who've already made the switch.

dialb.co/

About | FAQ | Privacy Policy | Terms of Use | Cookie Preferences