Copy page

Flag

Report incorrect data such as hard bounces, invalid emails, wrong organization info, phone numbers, or URLs. Confirmed flags result in automatic credit refunds.

Usage

Code
tomba flag list
tomba flag create --flag-type "<type>" --value "<value>" --reason "<reason>"

Examples

List Flags

Code
tomba flag list
tomba flag list --json

Create Flag

Code
# Report a hard bounce
tomba flag create --flag-type "email" --value "bounced@example.com" --reason "hard_bounce"

# Report wrong company
tomba flag create --flag-type "organization" --value "example.com" --reason "wrong_company"

# Report broken URL
tomba flag create --flag-type "website" --value "https://example.com" --reason "broken_url"

Flag Types & Valid Reasons

Flag Type	Valid Reasons
email	hard_bounce, invalid_email, wrong_person, outdated, other
organization	wrong_company, outdated, other
phone	wrong_phone, outdated, other
author_url	broken_url, wrong_person, outdated, other
website	broken_url, wrong_company, outdated, other

HTTP call

Code
# List flags
curl --request GET \
  --url 'http://127.0.0.1:3001/flags'

# Create flag
curl --request POST \
  --url 'http://127.0.0.1:3001/flags' \
  --header 'Content-Type: application/json' \
  --data '{"flag_type": "email", "value": "bounced@example.com", "reason": "hard_bounce"}'