Support

Report data quality issues and submit general support requests programmatically — the same flow used by the Report data issue button in the web app.

Both endpoints are free (no credits consumed) and authenticated the same way as the rest of the API. The reply-to address on every email is set to your account's email so the Sumble team can follow up with you directly.

Report a data quality issue

Report incorrect, missing, or stale Sumble data. Routed to the Sumble data team for triage.

curl https://api.sumble.com/v9/support/data-quality \
  --request POST \
  --header "Authorization: Bearer $API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
    "message": "The employee count for Acme looks stale",
    "url": "https://sumble.com/org/acme",
    "page_title": "Acme | Sumble"
  }'

Request body

Field	Type	Required	Description
message	string	Yes	Description of the issue. Max 5,000 characters.
url	string	No	The Sumble URL the issue relates to, if any.
page_title	string	No	The title of the Sumble page the issue relates to.

Response

{ "message": "Email sent successfully" }

Create Data Quality Report

post

Report a data quality issue. Routed to the data team for triage.

Authorizations

api_token

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

messagestring · max: 5000Required

urlstring · max: 2048 · nullableOptional

page_titlestring · max: 500 · nullableOptional

Responses

200

Successful Response

application/json

messagestringRequired

422

Validation Error

application/json

post/v9/support/data-quality

HTTPcURLJavaScriptPython

POST /v9/support/data-quality HTTP/1.1
Host: api.sumble.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 51

{
  "message": "text",
  "url": "text",
  "page_title": "text"
}

{
  "message": "text"
}

Submit a general support request

Submit an account, billing, or product question. Routed to the Sumble support inbox.

curl https://api.sumble.com/v9/support \
  --request POST \
  --header "Authorization: Bearer $API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
    "message": "How do I update my billing details?",
    "url": "https://sumble.com/account/billing"
  }'

Request body

Field	Type	Required	Description
message	string	Yes	Description of the request. Max 5,000 characters.
url	string	No	The Sumble URL the request relates to, if any.

Response

{ "message": "Email sent successfully" }

Create Support Request

post

Submit a general support request.

Authorizations

api_token

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

messagestring · max: 5000Required

urlstring · max: 2048 · nullableOptional

Responses

200

Successful Response

application/json

messagestringRequired

422

Validation Error

application/json

post/v9/support

HTTPcURLJavaScriptPython

POST /v9/support HTTP/1.1
Host: api.sumble.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 31

{
  "message": "text",
  "url": "text"
}

{
  "message": "text"
}