[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"docs-\u002Fdocs\u002Fapi\u002Fendpoints\u002Fsubscribers\u002Fdelete-subscriber":3},{"_path":4,"title":5,"description":6,"navigation":7,"image":13,"head":18,"body":32},"\u002Fdocs\u002Fapi\u002Fendpoints\u002Fsubscribers\u002Fdelete-subscriber","Delete Subscriber API Endpoint · Waitlister Documentation","Learn how to delete a subscriber from your waitlist using the Waitlister API.",{"title":8,"parent":9,"group":10,"description":11,"order":12},"Delete Subscriber","Endpoints","Advanced","Delete a subscriber from your waitlist by ID or email.",5,{"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 Delete Subscriber",{"meta":19},[20,23,26,29],{"name":21,"content":22},"keywords","delete subscriber, remove subscriber, waitlist api, api integration",{"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":444},"root",[35,49,55,69,74,110,117,154,160,167,177,183,245,251,262,268,281,292,298,405,411],{"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},"delete-subscriber",[54],{"type":47,"value":8},{"type":36,"tag":37,"props":56,"children":57},{},[58,60,67],{"type":47,"value":59},"The Delete Subscriber endpoint removes a subscriber from your waitlist by either their unique ID or email address. It's the counterpart to ",{"type":36,"tag":61,"props":62,"children":64},"a",{"href":63},"\u002Fdocs\u002Fapi\u002Fendpoints\u002Fsubscribers\u002Fadd-subscriber",[65],{"type":47,"value":66},"Add Subscriber",{"type":47,"value":68}," — useful for GDPR removal requests and cleaning up test data.",{"type":36,"tag":37,"props":70,"children":71},{},[72],{"type":47,"value":73},"Deletion runs through the same pipeline as the dashboard: the subscriber (and their email history) is removed, analytics counters are decremented, and queue positions are compacted. This happens asynchronously — expect counters and positions to update within a few minutes.",{"type":36,"tag":75,"props":76,"children":78},"callout",{"type":77},"note",[79],{"type":36,"tag":37,"props":80,"children":81},{},[82,84,92,94,101,103],{"type":47,"value":83},"Want the full picture in one fetch? The ",{"type":36,"tag":61,"props":85,"children":89},{"href":86,"rel":87},"https:\u002F\u002Fwaitlister.me\u002Fskill.md",[88],"nofollow",[90],{"type":47,"value":91},"one-page integration guide",{"type":47,"value":93}," covers every path with copy-paste code · ",{"type":36,"tag":61,"props":95,"children":98},{"href":96,"rel":97},"https:\u002F\u002Fwaitlister.me\u002Fopenapi.json",[88],[99],{"type":47,"value":100},"OpenAPI spec",{"type":47,"value":102}," · SDK: ",{"type":36,"tag":104,"props":105,"children":107},"code",{"className":106},[],[108],{"type":47,"value":109},"npm install waitlister",{"type":36,"tag":111,"props":112,"children":114},"h2",{"id":113},"endpoint-details",[115],{"type":47,"value":116},"Endpoint Details",{"type":36,"tag":118,"props":119,"children":120},"ul",{},[121,139],{"type":36,"tag":122,"props":123,"children":124},"li",{},[125,131,133],{"type":36,"tag":126,"props":127,"children":128},"strong",{},[129],{"type":47,"value":130},"URL",{"type":47,"value":132},": ",{"type":36,"tag":104,"props":134,"children":136},{"className":135},[],[137],{"type":47,"value":138},"https:\u002F\u002Fwaitlister.me\u002Fapi\u002Fv1\u002Fwaitlist\u002F{waitlist-key}\u002Fsubscribers\u002F{id-or-email}",{"type":36,"tag":122,"props":140,"children":141},{},[142,147,148],{"type":36,"tag":126,"props":143,"children":144},{},[145],{"type":47,"value":146},"Method",{"type":47,"value":132},{"type":36,"tag":104,"props":149,"children":151},{"className":150},[],[152],{"type":47,"value":153},"DELETE",{"type":36,"tag":111,"props":155,"children":157},{"id":156},"request",[158],{"type":47,"value":159},"Request",{"type":36,"tag":161,"props":162,"children":164},"h3",{"id":163},"headers",[165],{"type":47,"value":166},"Headers",{"type":36,"tag":168,"props":169,"children":171},"pre",{"code":170},"X-Api-Key: your-api-key\n",[172],{"type":36,"tag":104,"props":173,"children":175},{"__ignoreMap":174},"",[176],{"type":47,"value":170},{"type":36,"tag":161,"props":178,"children":180},{"id":179},"path-parameters",[181],{"type":47,"value":182},"Path Parameters",{"type":36,"tag":184,"props":185,"children":186},"table",{},[187,206],{"type":36,"tag":188,"props":189,"children":190},"thead",{},[191],{"type":36,"tag":192,"props":193,"children":194},"tr",{},[195,201],{"type":36,"tag":196,"props":197,"children":198},"th",{},[199],{"type":47,"value":200},"Parameter",{"type":36,"tag":196,"props":202,"children":203},{},[204],{"type":47,"value":205},"Description",{"type":36,"tag":207,"props":208,"children":209},"tbody",{},[210,228],{"type":36,"tag":192,"props":211,"children":212},{},[213,223],{"type":36,"tag":214,"props":215,"children":216},"td",{},[217],{"type":36,"tag":104,"props":218,"children":220},{"className":219},[],[221],{"type":47,"value":222},"waitlist-key",{"type":36,"tag":214,"props":224,"children":225},{},[226],{"type":47,"value":227},"Your unique waitlist key, found in your waitlist settings",{"type":36,"tag":192,"props":229,"children":230},{},[231,240],{"type":36,"tag":214,"props":232,"children":233},{},[234],{"type":36,"tag":104,"props":235,"children":237},{"className":236},[],[238],{"type":47,"value":239},"id-or-email",{"type":36,"tag":214,"props":241,"children":242},{},[243],{"type":47,"value":244},"Either the subscriber's unique ID or their email address",{"type":36,"tag":161,"props":246,"children":248},{"id":247},"example-request",[249],{"type":47,"value":250},"Example Request",{"type":36,"tag":168,"props":252,"children":257},{"code":253,"language":254,"meta":174,"className":255},"curl -X DELETE \"https:\u002F\u002Fwaitlister.me\u002Fapi\u002Fv1\u002Fwaitlist\u002Fyour-waitlist-key\u002Fsubscribers\u002Fuser@example.com\" \\\n  -H \"X-Api-Key: your-api-key\"\n","bash",[256],"language-bash",[258],{"type":36,"tag":104,"props":259,"children":260},{"__ignoreMap":174},[261],{"type":47,"value":253},{"type":36,"tag":111,"props":263,"children":265},{"id":264},"response",[266],{"type":47,"value":267},"Response",{"type":36,"tag":161,"props":269,"children":271},{"id":270},"success-response-200",[272,274],{"type":47,"value":273},"Success Response ",{"type":36,"tag":104,"props":275,"children":278},{"className":276},[277],"inline-code-green",[279],{"type":47,"value":280},"200",{"type":36,"tag":168,"props":282,"children":287},{"code":283,"language":284,"meta":174,"className":285},"{\n  \"success\": true,\n  \"message\": \"Subscriber deleted. Analytics and positions will update shortly.\"\n}\n","json",[286],"language-json",[288],{"type":36,"tag":104,"props":289,"children":290},{"__ignoreMap":174},[291],{"type":47,"value":283},{"type":36,"tag":161,"props":293,"children":295},{"id":294},"error-responses",[296],{"type":47,"value":297},"Error Responses",{"type":36,"tag":184,"props":299,"children":300},{},[301,316],{"type":36,"tag":188,"props":302,"children":303},{},[304],{"type":36,"tag":192,"props":305,"children":306},{},[307,312],{"type":36,"tag":196,"props":308,"children":309},{},[310],{"type":47,"value":311},"Status Code",{"type":36,"tag":196,"props":313,"children":314},{},[315],{"type":47,"value":205},{"type":36,"tag":207,"props":317,"children":318},{},[319,337,354,371,388],{"type":36,"tag":192,"props":320,"children":321},{},[322,332],{"type":36,"tag":214,"props":323,"children":324},{},[325],{"type":36,"tag":104,"props":326,"children":329},{"className":327},[328],"inline-code-red",[330],{"type":47,"value":331},"400",{"type":36,"tag":214,"props":333,"children":334},{},[335],{"type":47,"value":336},"Missing subscriber ID or email",{"type":36,"tag":192,"props":338,"children":339},{},[340,349],{"type":36,"tag":214,"props":341,"children":342},{},[343],{"type":36,"tag":104,"props":344,"children":346},{"className":345},[328],[347],{"type":47,"value":348},"401",{"type":36,"tag":214,"props":350,"children":351},{},[352],{"type":47,"value":353},"Invalid API key or waitlist key",{"type":36,"tag":192,"props":355,"children":356},{},[357,366],{"type":36,"tag":214,"props":358,"children":359},{},[360],{"type":36,"tag":104,"props":361,"children":363},{"className":362},[328],[364],{"type":47,"value":365},"403",{"type":36,"tag":214,"props":367,"children":368},{},[369],{"type":47,"value":370},"Your plan doesn't include this endpoint, or the subscriber belongs to another waitlist",{"type":36,"tag":192,"props":372,"children":373},{},[374,383],{"type":36,"tag":214,"props":375,"children":376},{},[377],{"type":36,"tag":104,"props":378,"children":380},{"className":379},[328],[381],{"type":47,"value":382},"404",{"type":36,"tag":214,"props":384,"children":385},{},[386],{"type":47,"value":387},"Subscriber not found",{"type":36,"tag":192,"props":389,"children":390},{},[391,400],{"type":36,"tag":214,"props":392,"children":393},{},[394],{"type":36,"tag":104,"props":395,"children":397},{"className":396},[328],[398],{"type":47,"value":399},"429",{"type":36,"tag":214,"props":401,"children":402},{},[403],{"type":47,"value":404},"Rate limit exceeded",{"type":36,"tag":111,"props":406,"children":408},{"id":407},"notes",[409],{"type":47,"value":410},"Notes",{"type":36,"tag":118,"props":412,"children":413},{},[414,426,431],{"type":36,"tag":122,"props":415,"children":416},{},[417,419,424],{"type":47,"value":418},"Deletion is ",{"type":36,"tag":126,"props":420,"children":421},{},[422],{"type":47,"value":423},"permanent",{"type":47,"value":425}," — the subscriber's data, points, and referral history cannot be restored.",{"type":36,"tag":122,"props":427,"children":428},{},[429],{"type":47,"value":430},"If the subscriber referred others, referral-derived points are recalculated by the same process the dashboard uses.",{"type":36,"tag":122,"props":432,"children":433},{},[434,436,442],{"type":47,"value":435},"The subscriber may still appear in ",{"type":36,"tag":61,"props":437,"children":439},{"href":438},"\u002Fdocs\u002Fapi\u002Fendpoints\u002Fsubscribers\u002Flist-subscribers",[440],{"type":47,"value":441},"List Subscribers",{"type":47,"value":443}," for a few seconds after the request returns, until asynchronous processing completes.",{"title":174,"searchDepth":445,"depth":445,"links":446},3,[447,449,454,459],{"id":113,"depth":448,"text":116},2,{"id":156,"depth":448,"text":159,"children":450},[451,452,453],{"id":163,"depth":445,"text":166},{"id":179,"depth":445,"text":182},{"id":247,"depth":445,"text":250},{"id":264,"depth":448,"text":267,"children":455},[456,458],{"id":270,"depth":445,"text":457},"Success Response 200",{"id":294,"depth":445,"text":297},{"id":407,"depth":448,"text":410}]