Skip to main content
POST
/
api
/
v2
/
public
/
tables
curl -X POST "https://app.refold.ai/api/v2/public/tables" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "linked_account_id: YOUR_LINKED_ACCOUNT_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "table_name": "leads",
    "columns": [ { "column_name": "email" }, { "column_name": "stage" } ]
  }'
{
  "table_id": "6a314fc3d396207fd2506a0a"
}
Create a persistent table with a set of columns for a linked account. Up to 20 columns can be defined at creation; add more later with Add Columns.

Authentication

x-api-key
string
required
Your Refold API key.
linked_account_id
string
required
The linked account the table belongs to.

Body Parameters

table_name
string
required
Name of the table. Example: leads
columns
array
required
Column definitions (max 20), each an object with a column_name.

Response

table_id
string
The ID of the new table.
{
  "table_id": "6a314fc3d396207fd2506a0a"
}
curl -X POST "https://app.refold.ai/api/v2/public/tables" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "linked_account_id: YOUR_LINKED_ACCOUNT_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "table_name": "leads",
    "columns": [ { "column_name": "email" }, { "column_name": "stage" } ]
  }'