Skip to main content
PUT
/
api
/
v2
/
public
/
linked-account
/
default-app
/
auth-credentials
/
:key
curl -X PUT "https://app.refold.ai/api/v2/public/linked-account/default-app/auth-credentials/{key}" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "linked_account_id: YOUR_LINKED_ACCOUNT_ID" \
  -H "Content-Type: application/json" \
  -d '{ "value": "YOUR_CREDENTIAL_VALUE" }'

{
  "success": true,
  "message": "Auth credential 'api_key' added successfully",
  "action": "added"
}
Add or update a single {key_name, key_value} auth credential on the linked account’s default-app integration. The value is encrypted before storage. The default-app integration must already exist on the account (it can be seeded when you create the linked account via your_app.auth_credentials).

​
Authentication

This endpoint accepts either authentication method. Option 1 — API key
​
x-api-key
string
Your Refold API key. Find it in Settings → Credentials.
​
linked_account_id
string
The linked account to operate on. May also be passed as a query parameter.
Option 2 — Session token
​
Authorization
string
Session token for the linked account (the account is taken from the token).Format: Bearer YOUR_SESSION_TOKEN

​
Path Parameters

​
key
string
required
The credential key name to add or update.Example: api_key

​
Body Parameters

​
value
string
required
The credential value. Coerced to a string and encrypted before storage.

​
Response

​
success
boolean
Whether the operation succeeded.
​
message
string
Confirmation message.
​
action
string
added or updated.
{
  "success": true,
  "message": "Auth credential 'api_key' added successfully",
  "action": "added"
}

curl -X PUT "https://app.refold.ai/api/v2/public/linked-account/default-app/auth-credentials/{key}" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "linked_account_id: YOUR_LINKED_ACCOUNT_ID" \
  -H "Content-Type: application/json" \
  -d '{ "value": "YOUR_CREDENTIAL_VALUE" }'