Create Source

POST

/sources

Create a new contact source.

Authentication

Required Scope: sources:write

Request Body

Field	Type	Required	Validation	Description
`name`	string	Yes	max:255, unique per tenant	Source name

Response

Success (201 Created): Returns the created source object. Includes message: "Source created successfully".

Response Fields

Field	Type	Description
`id`	integer	Source ID
`name`	string	Source name
`created_at`	string	ISO 8601 datetime
`updated_at`	string	ISO 8601 datetime

Error Responses

Status	Code	Description
422	`VALIDATION_ERROR`	Validation failed
500	`INTERNAL_ERROR`	Failed to create source

Validation Error Messages

Field	Message
`name`	Source name is required / A source with this name already exists

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Header Params

Body Params application/json

Examples

Responses

🟢200

application/json

Successful response

Body

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST '/sources' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name": "Website Form"
}'

Response Example

{}

Modified at 2026-02-25 01:06:20

List Sources

Get Source

Create Source

Authentication#

Request Body#

Response#

Response Fields#

Error Responses#

Validation Error Messages#