canonical: https://jentic.com/apis/dialb.co/dialb

# Dialb API

The Dialb API manages contacts, short links, digital cards, and webhooks for the Dialb platform and its Zapier integration. Agents create and update contacts, find them by email, and tag them, while short-link operations create and look up links and webhook operations subscribe to or cancel event notifications. Recent-activity endpoints list the latest contacts, short links, cards, and QR scans.

## For AI agents

Create, update, find, and tag contacts through Dialb, and create short links. Subscribe to webhook events, list recent activity, and look up digital cards by slug.

## Scope

Does not handle email sending, deal pipelines, or payment processing. Use for managing contacts, short links, cards, and webhooks only.

## Capabilities

- Add new contacts and keep their details up to date
- Find a contact by email or list the most recent contacts
- Tag a contact to group or segment it
- Create short links and look them up by search
- Subscribe to webhook events and unsubscribe when done
- List recent QR scans and find a digital card by slug

## Use cases

### Contact Capture Agent

An AI agent captures a new lead into Dialb: it searches by email to avoid duplicates, creates the contact if none exists, updates details, and tags it for the right segment. The agent discovers the search, create, update, and tag operations through Jentic by intent, so it captures contacts without hardcoding endpoint paths.

Example prompt: Search Dialb for a contact by email, create it if missing, update its details, and tag it for a segment

### Short Link Automation

A team wants trackable short links generated on demand. The agent creates a short link for a destination and can look up existing links by search, so campaigns reuse links rather than duplicate them. Dialb also records QR scans, which the agent lists to gauge engagement.

Example prompt: Create a short link for a destination URL, then list recent QR scans to report engagement

### Webhook-Driven Sync

An integration keeps Dialb in sync with another system. The agent subscribes to the relevant webhook event, processes notifications as they arrive, and unsubscribes when the integration is torn down. Because Dialb powers a Zapier integration, the same webhook events drive both custom and no-code automations.

Example prompt: Subscribe to a Dialb webhook event, then unsubscribe it by id when the integration is removed

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| GET | `/contacts/recent` | List recent contacts |
| GET | `/contacts/search` | Find a contact by email |
| POST | `/contacts` | Create a contact |
| PUT | `/contacts/{id}` | Update a contact |
| POST | `/contacts/{id}/tags` | Tag a contact |
| POST | `/short-links` | Create a short link |
| POST | `/webhooks/subscribe` | Subscribe to a webhook event |
| GET | `/qr-scans/recent` | List recent QR scans |

## Key resources

- **Contacts** — Create, update, search by email, list recent, and tag contacts
- **Short links** — Create short links and search existing ones
- **Webhooks** — Subscribe to and unsubscribe from webhook events
- **Cards and QR scans** — Find digital cards by slug and list recent QR scans

## AI readiness

This API is usable in Jentic One now. Its AI-readiness score against Jentic's framework shows where it stands today and where improvements would make it even easier for agents to use.

- **Score:** 43 / 100
- **Maturity:** Foundational
- **Dimensions:**
  - Foundational Compliance: 100 / 100
  - Developer Experience & Jentic Compatibility: 66 / 100
  - AI-Readiness & Agent Experience: 19 / 100
  - Agent Usability: 94 / 100
  - Security: 50 / 100
  - AI Discoverability: 82 / 100
- **View full report:** https://jentic.com/apis/dialb.co/dialb/scorecard
- **How the score is calculated:** https://docs.jentic.com/reference/api-readiness-framework/overview/
- **More about the dimensions:** https://docs.jentic.com/reference/api-readiness-framework/specification/#dimensional-model-overview

### Score it yourself

Every API in the directory is allowlisted, so you can re-score it with no key required.

- **Score your own API:** https://jentic.com/scorecard.md
- **Scoring CLI agent skill:** https://github.com/jentic/jentic-api-scorecard/blob/main/skills/jentic-api-scorecard/SKILL.md

```sh
npx @jentic/api-scorecard-cli score <openapi-url>
```

## Why Jentic

- **Setup:** Wiring Dialb by hand means issuing an API key, sending it in the X-API-Key header, and managing the webhook subscriptions that drive its Zapier integration yourself. Through Jentic you install once, import Dialb from the API Directory, store the key once, and your agent calls it.
- **Permission scoping:** You choose which Dialb operations your agent may call, so you can allow contact lookups and creation while leaving updates, tagging, and webhook subscriptions out unless you add them. Dialb carries the contact id in the URL path, so rules bound which operations run.
- **Credential handling:** Your Dialb key is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as find a contact by email or create a short link, and Jentic returns the matching Dialb operation with its input schema so the agent calls the right endpoint without reading the reference docs.

## Related APIs

- **Pipedrive** — Pipedrive is a full sales CRM with pipelines; Dialb focuses on contacts, short links, and digital cards.
- **HubSpot Contacts** — HubSpot stores the central contact record and marketing history; Dialb can feed new contacts captured in the field into it.
- **Dub** — Dub is a dedicated link-management platform; Dialb bundles short links alongside its contact features.

## FAQ

### What authentication does the Dialb API use?

The Dialb API authenticates with an API key sent in the X-API-Key request header, per its OpenAPI spec. Through Jentic the key is stored encrypted by your own Jentic One instance and injected at call time, so it never lands in the agent's prompt or logs.

### Can I manage contacts with the Dialb API?

Yes. You can create a contact, update it, find it by email, list the most recent contacts, and tag it. Combine search with create so your agent avoids making duplicate records.

### What are the rate limits for the Dialb API?

The OpenAPI spec does not publish rate limits for the Dialb API. Check Dialb's own API documentation for the current per-key limits before running frequent recent-activity polls.

### Can I limit what my agent is allowed to do with the Dialb API?

Yes. Write a rule that allows only contact lookups and creation, so the agent can capture leads while contact updates, tagging, and webhook subscriptions stay out unless you add them. Every call the agent makes is logged.

### How do I add a contact with the Dialb API through Jentic?

Search Jentic for an intent like create a contact, store your Dialb key once, and your agent calls the search operation to check for duplicates and then the create operation. To run it on your own infrastructure, install Jentic One from its GitHub repo.

### Is there a Dialb MCP server?

You don't need an MCP server to give your agent the Dialb API. Jentic connects it directly from the API Directory: import it, store your key once, and your agent calls the operations it needs on demand.