Skip to main content
Store your API key for one of the supported providers. Once set, Agentity uses this key when provisioning identity channels (email, phone, or virtual card) for your agents.
After setting a key, confirm it took effect by calling List Providers and verifying that isSet is true for that provider.

​
Path parameters

​
providerName
string
required
The name of the provider to configure. Must be one of:
  • AGENTMAIL — email address provisioning
  • AGENTPHONE — phone number provisioning
  • PRIVACY — virtual card provisioning

​
Request body

​
secret
string
required
Your API key for the specified provider.

​
Response

​
message
string
A confirmation message on success.
curl -X PUT https://api.agentity.to/providers/AGENTMAIL \
  -H "Authorization: Bearer YOUR_JWT" \
  -H "Content-Type: application/json" \
  -d '{"secret": "am_live_xxxxxxxxxxxxxxxxxxxx"}'

{
  "message": "Secret set successfully"
}