---
title: "Connect a service"
description: "Attach a reviewed service with write-only credentials or platform-managed credit."
image: "https://help.agent.mq/og.svg"
---

> Documentation Index
> Fetch the complete documentation index at: https://help.agent.mq/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect a service

The live connection response is the source of truth for available service definitions, fields, operation schemas, effects, and application connection state.

1. **List reviewed services and current connections**

```bash
curl https://api.agent.mq/v1/applications/app_<32-lowercase-hex>/connections \
  -H "Authorization: Bearer $AGENTMQ_TOKEN"
```
2. **Choose a connection model**

- **Bring your own:** send the required credential fields. AgentMQ encrypts them and never returns them.
- **Platform-backed:** send `platformConnectionId` instead of credentials. Calls reserve application credit.
3. **Save the connection**

```bash
curl -X PUT https://api.agent.mq/v1/applications/app_<32-lowercase-hex>/connections/<connection-id> \
  -H "Authorization: Bearer $AGENTMQ_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"provider":"<service-id>","name":"Production","credentials":{"<field>":"<secret>"},"operations":["<capability>"],"enabled":true,"dailyLimit":100}'
```
4. **Test deliberately**

   Use `POST /v1/applications/{appId}/service-invocations/{operationId}` with a caller-generated `requestKey`. Saving a connection validates configuration but makes no provider request.

## Verify

List connections again. The response shows metadata and enabled operations, never secret values.

## Capability groups

The reviewed catalog spans web retrieval, search and SEO, weather and places, translation, media and public archives, files and object storage, contacts and calendars, email and messaging, telephony, and application services. [See the capability guide](/build/capabilities), then discover the live catalog instead of relying on a copied count.

## Next steps

- [Use the configured DeepSeek search and fetch connection](/build/deepseek/)

- [Discover operations](/build/operations)
- [Explore supported capabilities](/build/capabilities)
- [Limits and reconciliation](/operate/limits)

Source: https://help.agent.mq/build/connections/index.mdx