Skip to main content
POST
/
api
/
v2
/
public
/
dataref
curl -X POST "https://app.refold.ai/api/v2/public/dataref" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "linked_account_id: YOUR_LINKED_ACCOUNT_ID" \
  -H "Content-Type: application/json" \
  -d '{ "refName": "contacts" }'

{
  "linked_account_id": "user_12345",
  "org_id": "6500a1b2c3d4e5f6a7b8c9d0",
  "environment": "test",
  "name": "contacts",
  "data": {},
  "_id": "6a3149efd396207fd24f7aad",
  "createdAt": "2026-06-16T13:04:47.926Z",
  "updatedAt": "2026-06-16T13:04:47.926Z",
  "__v": 0
}
Create a new, empty dataref (named reference-data store) for a linked account. Records are added later by workflows; the dataref starts with an empty data map.

​
Authentication

​
x-api-key
string
required
Your Refold API key.
​
linked_account_id
string
required
The linked account to create the dataref for.

​
Body Parameters

​
refName
string
required
The dataref name. Used to reference it in workflows and other endpoints.Example: contacts

​
Response

Returns the created dataref.
​
_id
string
Record ID.
​
name
string
Dataref name.
​
linked_account_id
string
Owning linked account.
​
environment
string
test or live.
​
data
object
Record map — empty on creation.
​
createdAt
string
ISO 8601 timestamp.
{
  "linked_account_id": "user_12345",
  "org_id": "6500a1b2c3d4e5f6a7b8c9d0",
  "environment": "test",
  "name": "contacts",
  "data": {},
  "_id": "6a3149efd396207fd24f7aad",
  "createdAt": "2026-06-16T13:04:47.926Z",
  "updatedAt": "2026-06-16T13:04:47.926Z",
  "__v": 0
}

curl -X POST "https://app.refold.ai/api/v2/public/dataref" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "linked_account_id: YOUR_LINKED_ACCOUNT_ID" \
  -H "Content-Type: application/json" \
  -d '{ "refName": "contacts" }'