Tomba icon

Tomba

Consume Tomba API

Flag → Create

AI-generated

Summary

Create a new flag in the Tomba system to report an issue with a specific type of data item (such as email, phone, organization, author URL, or website).

Inputs

  • Authentication — Choose the authentication method: OAuth2 or API Key.
  • Flag Type (required) — Select the type of data being flagged: Author URL, Email, Organization, Phone, or Website.
  • Value (required) — Provide the value (email address, domain, phone number, or URL) to be flagged, between 2 and 255 characters.
  • Reason (required) — Specify the reason for flagging the item, with valid reasons depending on the flag type. For example, for email: hard bounce, invalid email, wrong person, outdated, or other.
  • Comment — Optional additional details about the issue to include (up to 1000 characters).

Output shape

a single JSON object representing the created flag as returned by the Tomba API

Requires the flagType, value, and reason inputs. Comment is optional. The operation sends a POST request to the '/flag' endpoint with the given data and returns the API response containing details of the created flag.

Links

Discussion