canonical: https://jentic.com/apis/swapkaart.com/swapkaart

# Swapkaart API

Swapkaart is a digital business card platform for sales driven companies. This API provides access to authentication, contact management, and user information via Zapier integration endpoints. The API exposes 5 endpoints secured with bearer authentication.

## For AI agents

Programmatically login redirect for oauth flow, authenticate user and exchange credentials for tokens. Covers 5 operations with bearer authentication.

## Scope

Does not handle payments, communications, or developer tools - use for crm only.

## Capabilities

- Login redirect for OAuth flow
- Authenticate user and exchange credentials for tokens
- Exchange token for access and refresh tokens
- Fetch all contacts for the authenticated user
- Get authenticated user information

## Use cases

### CRM Operations

Use the Swapkaart API to perform crm operations programmatically. The API provides 5 endpoints covering core functionality including login redirect for oauth flow, authenticate user and exchange credentials for tokens, exchange token for access and refresh tokens.

Example prompt: Call GET `/zappier/login` to login redirect for oauth flow

### Automated Authentication Management

Automate authentication operations by combining multiple Swapkaart API endpoints. Agents can authenticate user and exchange credentials for tokens and then exchange token for access and refresh tokens in a single workflow.

Example prompt: Call POST `/zappier/auth` to authenticate user and exchange credentials for tokens, then verify the result

### AI Agent Integration via Jentic

AI agents discover and call Swapkaart API endpoints through Jentic without managing credentials directly. An agent searches for the required operation by intent, receives the matching endpoint schema, and executes the call with Jentic-managed authentication. This eliminates the need to read API documentation or handle bearer tokens manually.

Example prompt: Search Jentic for 'login redirect for oauth flow', load the operation schema, and execute with Jentic-managed credentials

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| GET | `/zappier/login` | Login redirect for OAuth flow |
| POST | `/zappier/auth` | Authenticate user and exchange credentials for tokens |
| POST | `/zappier/access` | Exchange token for access and refresh tokens |
| GET | `/zappier/contacts` | Fetch all contacts for the authenticated user |
| GET | `/me` | Get authenticated user information |

## Key resources

- **Authentication** — User authentication and token management
- **Contacts** — Contact management
- **Users** — User information

## 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:** 68 / 100
- **Maturity:** AI-Aware
- **Dimensions:**
  - Foundational Compliance: 100 / 100
  - Developer Experience & Jentic Compatibility: 60 / 100
  - AI-Readiness & Agent Experience: 53 / 100
  - Agent Usability: 94 / 100
  - Security: 60 / 100
  - AI Discoverability: 65 / 100
- **View full report:** https://jentic.com/apis/swapkaart.com/swapkaart/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 the Swapkaart API by hand means running its Firebase-token OAuth flow, attaching the bearer token to every call, and targeting its europe-west1 Cloud Functions host yourself. Through Jentic you install once, import the Swapkaart API from the API Directory, store the token once, and your agent calls it.
- **Permission scoping:** The Swapkaart API works through auth and contact endpoints that take their inputs in the request body or return the caller's own record, so limit the agent to the operations it needs, such as fetching contacts or reading the current profile. You decide which operations it may call, and the rest stay out of reach.
- **Credential handling:** Your Swapkaart API bearer token 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 'get my contacts' or 'read the current profile', and Jentic returns the matching Swapkaart API operation with its input schema so the agent calls the right endpoint without browsing the reference docs.

## Related APIs

- **Hubspot** — Alternative crm API
- **Salesforce** — Alternative crm API
- **Pipedrive** — Complementary crm API
- **Zoho** — Complementary crm API

## FAQ

### What authentication does the Swapkaart API use?

The Swapkaart API uses a Bearer token in the Authorization header. Through Jentic, these credentials are stored encrypted in your Jentic One instance and injected at execution time, so raw secrets never enter the agent context.

### Can I login redirect for oauth flow with the Swapkaart API?

Yes. Use the GET `/zappier/login` endpoint. The API returns structured JSON responses that agents can parse and act on directly.

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

Rate limits are not specified in the OpenAPI spec. Check the vendor documentation for current limits. Through Jentic, rate limiting is handled automatically with retry logic built into the execution layer.

### How do I login redirect for oauth flow through Jentic?

Install the Jentic SDK with pip install jentic, authenticate through Jentic One, the self-hosted execution layer, then search for 'login redirect for oauth flow'. Jentic returns the matching Swapkaart API operation with its input schema. Load the schema and execute the call - credentials are injected automatically.

### How many endpoints does the Swapkaart API have?

The Swapkaart API exposes 5 endpoints covering authentication, contacts, users operations.

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

Yes. Because Jentic One is self-hosted, your own rules decide which Swapkaart API operations and credentials the agent may use. You can restrict it to only the endpoints it needs, such as GET `/zappier/contacts` to fetch contacts or GET /me to read the current profile, while keeping the authentication endpoints like POST `/zappier/auth` and POST `/zappier/access` out of reach. The operations you do not grant stay unavailable to the agent.