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

string
required
Bearer token. Example: Bearer agd_live_xxxxxxxxxxxxxxxxxxxx

Body Parameters

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

Response

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

Examples

Response

Errors