Create a Lead source for API business submissions

POST/source-channels/

Create a Lead source to track businesses submitted by this integration. Use its business contract to discover the accepted submission fields. Check readiness before submitting businesses; if setup is missing, ask a Portal administrator to resolve it.

Required permissions: source_channels:write
Available scopes: Entire Portal

Headers and URL parameters

Name	Location	Type	Required
`Idempotency-Key` View parameter schema	header	string	Yes

Request body

application/json · Required body

Field	Type	Required
`name`	string	Yes
`starting_experience`Required. Choose how new businesses start. The selected experience must be allowed for this provider. Matchmaking initializes self-serve access on new client relationships; later source changes do not change existing access.	string	Yes

View request schema

Example request

curl --request POST \
  --url "https://api.staging.levr.ai/v1/source-channels/" \
  --header "Authorization: Bearer $LEVR_API_KEY" \
  --header "Idempotency-Key: $IDEMPOTENCY_KEY" \
  --header "Content-Type: application/json" \
  --data "@request.json"

curl --request POST \
  --url "https://api.staging.levr.ai/v1/source-channels/" \
  --header "Authorization: Bearer $LEVR_API_KEY" \
  --header "Idempotency-Key: $IDEMPOTENCY_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "name": "Growth financing intake",
  "starting_experience": "business_profile"
}'

Responses

Status	What it means
`201`	The source channel was created. View response headers `application/json` View response schema Illustrative data. Use the identifiers, cursors, and URLs returned by your requests. View example response
`400`	Correct the request fields and try again. View response headers `application/json` View response schema Illustrative data. Use the identifiers, cursors, and URLs returned by your requests. View example response
`401`	Provide a valid API key and try again. View response headers `application/json` View response schema Illustrative data. Use the identifiers, cursors, and URLs returned by your requests. View example response
`403`	This API key does not allow the requested action. View response headers `application/json` View response schema Illustrative data. Use the identifiers, cursors, and URLs returned by your requests. View example response
`409`	The request conflicts with the resource's current state. Refresh it before trying again. View response headers `application/json` View response schema Illustrative data. Use the identifiers, cursors, and URLs returned by your requests. View example response
`429`	Too many requests were sent. Wait before trying again. View response headers `application/json` View response schema Illustrative data. Use the identifiers, cursors, and URLs returned by your requests. View example response
`500`	Levr could not complete the request. Keep the request ID and retry when safe. View response headers `application/json` View response schema Illustrative data. Use the identifiers, cursors, and URLs returned by your requests. View example response

Copy instructions to your AI agent

Request an integration