Skip to main content
POST
Create Connection
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

Response

Errors