Create Site

Create a new site to organize forms by website or client.

sites.create
POST/v1/sites

Request Body

ParameterTypeDescription
name*stringSite name (max 255 chars)
domainstringDomain name (e.g., example.com)
notesstringInternal notes
notificationEmailstringDefault notification email for this site
timezonestringTimezone (default: America/Denver)
emailFromNamestringDefault sender name for notifications
emailReplyTostringDefault reply-to email
emailRecipientsstringDefault notification recipients (JSON array)
emailCcstringDefault CC addresses
emailBccstringDefault BCC addresses
referencePrefixstringShort prefix for submission IDs (max 4 chars, e.g., "MW")

Example Request

curl
curl -X POST "https://proforms.io/api/v1/sites" \
  -H "Authorization: Bearer pf_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Client Website",
    "domain": "clientsite.com",
    "notificationEmail": "leads@clientsite.com",
    "timezone": "America/Denver",
    "referencePrefix": "CW"
  }'

Response

200 OK
{
  "success": true,
  "data": {
    "id": "s_new123",
    "name": "Client Website",
    "domain": "clientsite.com",
    "status": "active",
    "createdAt": "2026-02-17T11:00:00.000Z"
  }
}