[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"docs-\u002Fdocs\u002Fapi\u002Fendpoints\u002Flanding-page\u002Fcreate-landing-page":3},{"_path":4,"title":5,"description":6,"navigation":7,"image":13,"head":18,"body":32},"\u002Fdocs\u002Fapi\u002Fendpoints\u002Flanding-page\u002Fcreate-landing-page","Create Landing Page API Endpoint · Waitlister Documentation","Create a waitlist's hosted landing page programmatically with structured fields — headline, description, theme, SEO — using the Waitlister API.",{"title":8,"parent":9,"group":10,"description":11,"order":12},"Create Landing Page","Endpoints","Advanced","Create a waitlist's hosted landing page from structured fields via the API.",10,{"src":14,"width":15,"height":16,"alt":17},"https:\u002F\u002Ffirebasestorage.googleapis.com\u002Fv0\u002Fb\u002Fwaitinglist-app-c24fc.appspot.com\u002Fo\u002Fdocs-og-image.png?alt=media&token=85e60b24-c882-4f84-aa9e-ef85e1ae4bb5",400,300,"Waitlister API Create Landing Page",{"meta":19},[20,23,26,29],{"name":21,"content":22},"keywords","create landing page, landing page api, waitlist landing page, programmatic landing page",{"name":24,"content":25},"robots","index, follow",{"name":27,"content":28},"author","Waitlister",{"name":30,"content":31},"copyright","© 2026 Waitlister",{"type":33,"children":34,"toc":757},"root",[35,49,55,77,107,135,160,167,203,209,216,226,232,252,547,553,564,570,583,594,600,711,717],{"type":36,"tag":37,"props":38,"children":39},"element","p",{},[40],{"type":36,"tag":41,"props":42,"children":45},"span",{"className":43},[44],"secondary-heading",[46],{"type":47,"value":48},"text","API Reference \u002F Endpoints",{"type":36,"tag":50,"props":51,"children":53},"h1",{"id":52},"create-landing-page",[54],{"type":47,"value":8},{"type":36,"tag":37,"props":56,"children":57},{},[58,60,66,68,75],{"type":47,"value":59},"Creates the waitlist's hosted landing page from structured fields — headline, description, button text, theme, background, and SEO. The page is created as a ",{"type":36,"tag":61,"props":62,"children":63},"strong",{},[64],{"type":47,"value":65},"draft",{"type":47,"value":67},": nothing goes live until you call ",{"type":36,"tag":69,"props":70,"children":72},"a",{"href":71},"\u002Fdocs\u002Fapi\u002Fendpoints\u002Flanding-page\u002Fpublish-landing-page",[73],{"type":47,"value":74},"Publish Landing Page",{"type":47,"value":76},".",{"type":36,"tag":37,"props":78,"children":79},{},[80,82,87,89,97,99,105],{"type":47,"value":81},"Each waitlist has ",{"type":36,"tag":61,"props":83,"children":84},{},[85],{"type":47,"value":86},"one",{"type":47,"value":88}," landing page — if one already exists (created here or in the dashboard), this endpoint returns ",{"type":36,"tag":90,"props":91,"children":94},"code",{"className":92},[93],"inline-code-red",[95],{"type":47,"value":96},"409",{"type":47,"value":98},"; use ",{"type":36,"tag":69,"props":100,"children":102},{"href":101},"\u002Fdocs\u002Fapi\u002Fendpoints\u002Flanding-page\u002Fupdate-landing-page",[103],{"type":47,"value":104},"Update Landing Page",{"type":47,"value":106}," instead.",{"type":36,"tag":37,"props":108,"children":109},{},[110,112,117,119,125,127,133],{"type":47,"value":111},"Available on ",{"type":36,"tag":61,"props":113,"children":114},{},[115],{"type":47,"value":116},"every plan",{"type":47,"value":118}," with an ",{"type":36,"tag":69,"props":120,"children":122},{"href":121},"\u002Fdocs\u002Fapi\u002Fauthentication",[123],{"type":47,"value":124},"account API key",{"type":47,"value":126}," (",{"type":36,"tag":90,"props":128,"children":130},{"className":129},[],[131],{"type":47,"value":132},"wl_acct_…",{"type":47,"value":134},"); per-waitlist keys work on Growth+.",{"type":36,"tag":136,"props":137,"children":139},"callout",{"type":138},"note",[140],{"type":36,"tag":37,"props":141,"children":142},{},[143,145,151,153,159],{"type":47,"value":144},"You can also provision the page in the same request that creates the waitlist — pass a ",{"type":36,"tag":90,"props":146,"children":148},{"className":147},[],[149],{"type":47,"value":150},"landing_page",{"type":47,"value":152}," object to ",{"type":36,"tag":69,"props":154,"children":156},{"href":155},"\u002Fdocs\u002Fapi\u002Fendpoints\u002Fwaitlists\u002Fcreate-waitlist",[157],{"type":47,"value":158},"Create Waitlist",{"type":47,"value":76},{"type":36,"tag":161,"props":162,"children":164},"h2",{"id":163},"endpoint-details",[165],{"type":47,"value":166},"Endpoint Details",{"type":36,"tag":168,"props":169,"children":170},"ul",{},[171,188],{"type":36,"tag":172,"props":173,"children":174},"li",{},[175,180,182],{"type":36,"tag":61,"props":176,"children":177},{},[178],{"type":47,"value":179},"URL",{"type":47,"value":181},": ",{"type":36,"tag":90,"props":183,"children":185},{"className":184},[],[186],{"type":47,"value":187},"https:\u002F\u002Fwaitlister.me\u002Fapi\u002Fv1\u002Fwaitlist\u002F{waitlistKey}\u002Flanding-page",{"type":36,"tag":172,"props":189,"children":190},{},[191,196,197],{"type":36,"tag":61,"props":192,"children":193},{},[194],{"type":47,"value":195},"Method",{"type":47,"value":181},{"type":36,"tag":90,"props":198,"children":200},{"className":199},[],[201],{"type":47,"value":202},"POST",{"type":36,"tag":161,"props":204,"children":206},{"id":205},"request",[207],{"type":47,"value":208},"Request",{"type":36,"tag":210,"props":211,"children":213},"h3",{"id":212},"headers",[214],{"type":47,"value":215},"Headers",{"type":36,"tag":217,"props":218,"children":220},"pre",{"code":219},"Content-Type: application\u002Fjson\nX-Api-Key: wl_acct_your-account-api-key\n",[221],{"type":36,"tag":90,"props":222,"children":224},{"__ignoreMap":223},"",[225],{"type":47,"value":219},{"type":36,"tag":210,"props":227,"children":229},{"id":228},"body-parameters",[230],{"type":47,"value":231},"Body Parameters",{"type":36,"tag":37,"props":233,"children":234},{},[235,237,242,244,250],{"type":47,"value":236},"All text fields are ",{"type":36,"tag":61,"props":238,"children":239},{},[240],{"type":47,"value":241},"plain text",{"type":47,"value":243}," — HTML is rejected. Unknown keys return ",{"type":36,"tag":90,"props":245,"children":247},{"className":246},[93],[248],{"type":47,"value":249},"400",{"type":47,"value":251}," listing the allowed keys.",{"type":36,"tag":253,"props":254,"children":255},"table",{},[256,285],{"type":36,"tag":257,"props":258,"children":259},"thead",{},[260],{"type":36,"tag":261,"props":262,"children":263},"tr",{},[264,270,275,280],{"type":36,"tag":265,"props":266,"children":267},"th",{},[268],{"type":47,"value":269},"Parameter",{"type":36,"tag":265,"props":271,"children":272},{},[273],{"type":47,"value":274},"Type",{"type":36,"tag":265,"props":276,"children":277},{},[278],{"type":47,"value":279},"Required",{"type":36,"tag":265,"props":281,"children":282},{},[283],{"type":47,"value":284},"Description",{"type":36,"tag":286,"props":287,"children":288},"tbody",{},[289,317,343,368,394,419,451,488],{"type":36,"tag":261,"props":290,"children":291},{},[292,302,307,312],{"type":36,"tag":293,"props":294,"children":295},"td",{},[296],{"type":36,"tag":90,"props":297,"children":299},{"className":298},[],[300],{"type":47,"value":301},"headline",{"type":36,"tag":293,"props":303,"children":304},{},[305],{"type":47,"value":306},"String",{"type":36,"tag":293,"props":308,"children":309},{},[310],{"type":47,"value":311},"Yes",{"type":36,"tag":293,"props":313,"children":314},{},[315],{"type":47,"value":316},"The page's main title (3–120 characters)",{"type":36,"tag":261,"props":318,"children":319},{},[320,329,333,338],{"type":36,"tag":293,"props":321,"children":322},{},[323],{"type":36,"tag":90,"props":324,"children":326},{"className":325},[],[327],{"type":47,"value":328},"description",{"type":36,"tag":293,"props":330,"children":331},{},[332],{"type":47,"value":306},{"type":36,"tag":293,"props":334,"children":335},{},[336],{"type":47,"value":337},"No",{"type":36,"tag":293,"props":339,"children":340},{},[341],{"type":47,"value":342},"Supporting copy under the headline (max 1000 characters)",{"type":36,"tag":261,"props":344,"children":345},{},[346,355,359,363],{"type":36,"tag":293,"props":347,"children":348},{},[349],{"type":36,"tag":90,"props":350,"children":352},{"className":351},[],[353],{"type":47,"value":354},"button_text",{"type":36,"tag":293,"props":356,"children":357},{},[358],{"type":47,"value":306},{"type":36,"tag":293,"props":360,"children":361},{},[362],{"type":47,"value":337},{"type":36,"tag":293,"props":364,"children":365},{},[366],{"type":47,"value":367},"Submit-button label (max 40 characters, default \"Join the waitlist\")",{"type":36,"tag":261,"props":369,"children":370},{},[371,380,385,389],{"type":36,"tag":293,"props":372,"children":373},{},[374],{"type":36,"tag":90,"props":375,"children":377},{"className":376},[],[378],{"type":47,"value":379},"collect_name",{"type":36,"tag":293,"props":381,"children":382},{},[383],{"type":47,"value":384},"Boolean",{"type":36,"tag":293,"props":386,"children":387},{},[388],{"type":47,"value":337},{"type":36,"tag":293,"props":390,"children":391},{},[392],{"type":47,"value":393},"Add a name input to the signup form",{"type":36,"tag":261,"props":395,"children":396},{},[397,406,410,414],{"type":36,"tag":293,"props":398,"children":399},{},[400],{"type":36,"tag":90,"props":401,"children":403},{"className":402},[],[404],{"type":47,"value":405},"collect_phone",{"type":36,"tag":293,"props":407,"children":408},{},[409],{"type":47,"value":384},{"type":36,"tag":293,"props":411,"children":412},{},[413],{"type":47,"value":337},{"type":36,"tag":293,"props":415,"children":416},{},[417],{"type":47,"value":418},"Add a phone input to the signup form",{"type":36,"tag":261,"props":420,"children":421},{},[422,431,436,440],{"type":36,"tag":293,"props":423,"children":424},{},[425],{"type":36,"tag":90,"props":426,"children":428},{"className":427},[],[429],{"type":47,"value":430},"background",{"type":36,"tag":293,"props":432,"children":433},{},[434],{"type":47,"value":435},"Object",{"type":36,"tag":293,"props":437,"children":438},{},[439],{"type":47,"value":337},{"type":36,"tag":293,"props":441,"children":442},{},[443,449],{"type":36,"tag":90,"props":444,"children":446},{"className":445},[],[447],{"type":47,"value":448},"{ \"type\": \"color\" | \"gradient\", \"value\": \"…\" }",{"type":47,"value":450}," — hex color or CSS gradient string. Image backgrounds are dashboard-only",{"type":36,"tag":261,"props":452,"children":453},{},[454,463,467,471],{"type":36,"tag":293,"props":455,"children":456},{},[457],{"type":36,"tag":90,"props":458,"children":460},{"className":459},[],[461],{"type":47,"value":462},"theme",{"type":36,"tag":293,"props":464,"children":465},{},[466],{"type":47,"value":306},{"type":36,"tag":293,"props":468,"children":469},{},[470],{"type":47,"value":337},{"type":36,"tag":293,"props":472,"children":473},{},[474,480,482],{"type":36,"tag":90,"props":475,"children":477},{"className":476},[],[478],{"type":47,"value":479},"light",{"type":47,"value":481}," (default) or ",{"type":36,"tag":90,"props":483,"children":485},{"className":484},[],[486],{"type":47,"value":487},"dark",{"type":36,"tag":261,"props":489,"children":490},{},[491,500,504,508],{"type":36,"tag":293,"props":492,"children":493},{},[494],{"type":36,"tag":90,"props":495,"children":497},{"className":496},[],[498],{"type":47,"value":499},"seo",{"type":36,"tag":293,"props":501,"children":502},{},[503],{"type":47,"value":435},{"type":36,"tag":293,"props":505,"children":506},{},[507],{"type":47,"value":337},{"type":36,"tag":293,"props":509,"children":510},{},[511,517,519,524,526,531,533,539,541],{"type":36,"tag":90,"props":512,"children":514},{"className":513},[],[515],{"type":47,"value":516},"title",{"type":47,"value":518}," (max 70), ",{"type":36,"tag":90,"props":520,"children":522},{"className":521},[],[523],{"type":47,"value":328},{"type":47,"value":525}," (max 200), ",{"type":36,"tag":90,"props":527,"children":529},{"className":528},[],[530],{"type":47,"value":21},{"type":47,"value":532}," (max 10 × 40 chars), ",{"type":36,"tag":90,"props":534,"children":536},{"className":535},[],[537],{"type":47,"value":538},"og_title",{"type":47,"value":540},", ",{"type":36,"tag":90,"props":542,"children":544},{"className":543},[],[545],{"type":47,"value":546},"og_description",{"type":36,"tag":210,"props":548,"children":550},{"id":549},"example-request",[551],{"type":47,"value":552},"Example Request",{"type":36,"tag":217,"props":554,"children":559},{"code":555,"language":556,"meta":223,"className":557},"curl -X POST \"https:\u002F\u002Fwaitlister.me\u002Fapi\u002Fv1\u002Fwaitlist\u002FWAITLIST_KEY\u002Flanding-page\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -H \"X-Api-Key: wl_acct_your-account-api-key\" \\\n  -d '{\n    \"headline\": \"Join the beta\",\n    \"description\": \"Early access for the first 100 signups.\",\n    \"button_text\": \"Get early access\",\n    \"collect_name\": true,\n    \"theme\": \"dark\",\n    \"background\": { \"type\": \"color\", \"value\": \"#0F172A\" }\n  }'\n","bash",[558],"language-bash",[560],{"type":36,"tag":90,"props":561,"children":562},{"__ignoreMap":223},[563],{"type":47,"value":555},{"type":36,"tag":161,"props":565,"children":567},{"id":566},"response",[568],{"type":47,"value":569},"Response",{"type":36,"tag":210,"props":571,"children":573},{"id":572},"success-response-201",[574,576],{"type":47,"value":575},"Success Response ",{"type":36,"tag":90,"props":577,"children":580},{"className":578},[579],"inline-code-green",[581],{"type":47,"value":582},"201",{"type":36,"tag":217,"props":584,"children":589},{"code":585,"language":586,"meta":223,"className":587},"{\n  \"success\": true,\n  \"data\": {\n    \"landing_page\": {\n      \"id\": \"aBcDeFgH123\",\n      \"status\": \"draft\",\n      \"page_type\": \"standard\",\n      \"preview\": {\n        \"headline\": \"Join the beta\",\n        \"description\": \"Early access for the first 100 signups.\",\n        \"button_text\": \"Get early access\"\n      },\n      \"hosted_page_url\": null,\n      \"draft_note\": \"Publish with POST \u002Fapi\u002Fv1\u002Fwaitlist\u002F{waitlistKey}\u002Flanding-page\u002Fpublish\"\n    }\n  }\n}\n","json",[588],"language-json",[590],{"type":36,"tag":90,"props":591,"children":592},{"__ignoreMap":223},[593],{"type":47,"value":585},{"type":36,"tag":210,"props":595,"children":597},{"id":596},"error-responses",[598],{"type":47,"value":599},"Error Responses",{"type":36,"tag":253,"props":601,"children":602},{},[603,618],{"type":36,"tag":257,"props":604,"children":605},{},[606],{"type":36,"tag":261,"props":607,"children":608},{},[609,614],{"type":36,"tag":265,"props":610,"children":611},{},[612],{"type":47,"value":613},"Status Code",{"type":36,"tag":265,"props":615,"children":616},{},[617],{"type":47,"value":284},{"type":36,"tag":286,"props":619,"children":620},{},[621,644,661,677,694],{"type":36,"tag":261,"props":622,"children":623},{},[624,632],{"type":36,"tag":293,"props":625,"children":626},{},[627],{"type":36,"tag":90,"props":628,"children":630},{"className":629},[93],[631],{"type":47,"value":249},{"type":36,"tag":293,"props":633,"children":634},{},[635,637,642],{"type":47,"value":636},"Missing\u002Finvalid ",{"type":36,"tag":90,"props":638,"children":640},{"className":639},[],[641],{"type":47,"value":301},{"type":47,"value":643},", an unknown key (the message lists allowed keys), or a field over its length cap",{"type":36,"tag":261,"props":645,"children":646},{},[647,656],{"type":36,"tag":293,"props":648,"children":649},{},[650],{"type":36,"tag":90,"props":651,"children":653},{"className":652},[93],[654],{"type":47,"value":655},"401",{"type":36,"tag":293,"props":657,"children":658},{},[659],{"type":47,"value":660},"Missing or invalid API key \u002F waitlist key",{"type":36,"tag":261,"props":662,"children":663},{},[664,672],{"type":36,"tag":293,"props":665,"children":666},{},[667],{"type":36,"tag":90,"props":668,"children":670},{"className":669},[93],[671],{"type":47,"value":96},{"type":36,"tag":293,"props":673,"children":674},{},[675],{"type":47,"value":676},"The waitlist already has a landing page — update it instead",{"type":36,"tag":261,"props":678,"children":679},{},[680,689],{"type":36,"tag":293,"props":681,"children":682},{},[683],{"type":36,"tag":90,"props":684,"children":686},{"className":685},[93],[687],{"type":47,"value":688},"429",{"type":36,"tag":293,"props":690,"children":691},{},[692],{"type":47,"value":693},"Rate limit exceeded (5\u002Fmin; 10\u002Fmin on Growth+)",{"type":36,"tag":261,"props":695,"children":696},{},[697,706],{"type":36,"tag":293,"props":698,"children":699},{},[700],{"type":36,"tag":90,"props":701,"children":703},{"className":702},[93],[704],{"type":47,"value":705},"503",{"type":36,"tag":293,"props":707,"children":708},{},[709],{"type":47,"value":710},"The landing-page API is temporarily disabled",{"type":36,"tag":161,"props":712,"children":714},{"id":713},"next-steps",[715],{"type":47,"value":716},"Next Steps",{"type":36,"tag":168,"props":718,"children":719},{},[720,736,746],{"type":36,"tag":172,"props":721,"children":722},{},[723,728,730],{"type":36,"tag":69,"props":724,"children":725},{"href":71},[726],{"type":47,"value":727},"Publish the page",{"type":47,"value":729}," to go live at ",{"type":36,"tag":90,"props":731,"children":733},{"className":732},[],[734],{"type":47,"value":735},"waitlister.me\u002Fp\u002F{slug}",{"type":36,"tag":172,"props":737,"children":738},{},[739,744],{"type":36,"tag":69,"props":740,"children":741},{"href":101},[742],{"type":47,"value":743},"Update fields",{"type":47,"value":745}," any time — live pages update immediately",{"type":36,"tag":172,"props":747,"children":748},{},[749,751],{"type":47,"value":750},"Or let the ",{"type":36,"tag":69,"props":752,"children":754},{"href":753},"\u002Fdocs\u002Fapi\u002Fendpoints\u002Flanding-page\u002Fgenerate-landing-page",[755],{"type":47,"value":756},"AI builder generate the whole page",{"title":223,"searchDepth":758,"depth":758,"links":759},3,[760,762,767,772],{"id":163,"depth":761,"text":166},2,{"id":205,"depth":761,"text":208,"children":763},[764,765,766],{"id":212,"depth":758,"text":215},{"id":228,"depth":758,"text":231},{"id":549,"depth":758,"text":552},{"id":566,"depth":761,"text":569,"children":768},[769,771],{"id":572,"depth":758,"text":770},"Success Response 201",{"id":596,"depth":758,"text":599},{"id":713,"depth":761,"text":716}]