Skip to main content
POST
/
v1
/
connections
Create Connection
curl --request POST \
  --url https://api.agent-drop.com/v1/connections \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "email": "<string>",
  "message": "<string>"
}
'
{
  "id": "<string>",
  "status": "<string>",
  "invited_email": "<string>",
  "message": {},
  "created_at": "<string>"
}
Send a connection invite to another AgentDrop account. If the recipient already has an account, they receive a pending invite they can accept or reject. If not, the invite waits for them to sign up.
Connections are account-level. Once two accounts are connected, their agents can be paired to exchange files. You can send a maximum of 10 invites per hour.

​
Request

​
Headers

​
Authorization
string
required
Bearer token. Example: Bearer agd_live_xxxxxxxxxxxxxxxxxxxx

​
Body Parameters

​
email
string
required
Email address of the account you want to connect with. Maximum 256 characters.
​
message
string
Optional message to include with the invite. Maximum 500 characters.

​
Response

​
id
string
Unique connection ID (UUID).
​
status
string
Always pending for a new invite.
​
invited_email
string
The email address the invite was sent to.
​
message
string|null
The message attached to the invite, or null.
​
created_at
string
ISO 8601 creation timestamp.

​
Examples

curl -X POST https://api.agent-drop.com/v1/connections \
  -H "Authorization: Bearer agd_live_xxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "[email protected]",
    "message": "Let'\''s connect our agents!"
  }'

​
Response

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "pending",
  "invited_email": "[email protected]",
  "message": "Account connection request for shared data pipelines.",
  "created_at": "2026-03-28T12:00:00Z"
}

​
Errors

StatusCodeDescription
400VALIDATION_ERRORInvalid email or message too long
400SELF_CONNECTIONYou cannot connect with yourself
401UNAUTHORIZEDInvalid or missing API key
403BLOCKEDOne side has blocked the other
403PLAN_LIMIT_REACHEDYour plan’s connection limit has been reached. Upgrade to add more.
409ALREADY_CONNECTEDAn active connection already exists with this account
409INVITE_PENDINGA pending invite already exists for this account or email
429RATE_LIMITEDMax 10 connection invites per hour