X lead generation form: name up to 255 characters, purpose 1000
X's Ads API lead generation docs cap a form name at 1 to 255 characters and its purpose at 1 to 1000. Validate copy variants before you create the form.

X's lead generation documentation gives a form name of 1 to 255 characters and a purpose of 1 to 1000 characters, and requires an https:// privacy policy URL. If you draft those fields in a Sume bulk run, validate lengths and the URL scheme in code, since a schema shapes keys but not length.
Field limits
| Field | Rule |
|---|---|
| Form name | 1 to 255 characters |
| Purpose | 1 to 1000 characters |
| Privacy policy URL | Must be https:// |
A validator for generated copy
Run it over every finished queue item. The page does not give limits for card titles or CTAs, so none are checked here.
def check(form: dict) -> list[str]:
errs = []
if not 1 <= len(form.get("name", "")) <= 255:
errs.append("name must be 1-255 characters")
if not 1 <= len(form.get("purpose", "")) <= 1000:
errs.append("purpose must be 1-1000 characters")
if not form.get("privacy_policy_url", "").startswith("https://"):
errs.append("privacy policy URL must start with https://")
return errs
print(check({"name": "Demo request", "purpose": "Get a demo.", "privacy_policy_url": "https://example.com/privacy"}))
print(check({"name": "", "purpose": "x" * 1001, "privacy_policy_url": "http://example.com"}))Next step
Resubmit only failing items; a failed or canceled item keeps its index in the queue receipt.
Sources
Related posts
More in Use cases
- X lead generation form fields: work email, job title, company
X's lead generation docs list contact and user-information fields, including WORK_EMAIL, JOB_TITLE and COMPANY_NAME. Pick fields to match each ad variant.
- X post media mix: 4 photos, 1 GIF or 1 video, and 0.5 s video minimum
An X post can carry up to 4 photos, or 1 animated GIF, or 1 video, and video must be at least 0.5 seconds. Pick the right Sume export for each case.
- Yoga studio class promo clip: Kling 3 for 8 seconds, audio or silent
An 8-second class promo clip with kling-3 on Sume costs $1.12 silent and $1.68 with audio; vertical 9:16 at 720p or 1080p is the same rate.
- YouTube can add the AI label itself, even if you skip the toggle
YouTube may auto-apply AI labels for its own GenAI tools, C2PA metadata, or content its systems detect. Sume docs promise no C2PA, so disclose yourself.
Written by Sume