[{"data":1,"prerenderedAt":699},["ShallowReactive",2],{"docs-navigation":3,"\u002Fdocs\u002Faudience\u002Fcontacts":202,"\u002Fdocs\u002Faudience\u002Fcontacts-surround":694},[4],{"title":5,"path":6,"stem":7,"children":8,"page":22},"Docs","\u002Fdocs","docs",[9,23,36,65,86,115,128,172,185],{"title":10,"path":11,"stem":12,"children":13,"page":22},"Getting started","\u002Fdocs\u002Fgetting-started","docs\u002F1.getting-started",[14,18],{"title":15,"path":16,"stem":17},"Quickstart","\u002Fdocs\u002Fgetting-started\u002Fquickstart","docs\u002F1.getting-started\u002F1.quickstart",{"title":19,"path":20,"stem":21},"Concepts","\u002Fdocs\u002Fgetting-started\u002Fconcepts","docs\u002F1.getting-started\u002F2.concepts",false,{"title":24,"path":25,"stem":26,"children":27,"page":22},"Sending domain","\u002Fdocs\u002Fdomains","docs\u002F2.domains",[28,32],{"title":29,"path":30,"stem":31},"Add your domain","\u002Fdocs\u002Fdomains\u002Fadd-your-domain","docs\u002F2.domains\u002F1.add-your-domain",{"title":33,"path":34,"stem":35},"Troubleshooting","\u002Fdocs\u002Fdomains\u002Ftroubleshooting","docs\u002F2.domains\u002F2.troubleshooting",{"title":37,"path":38,"stem":39,"children":40,"page":22},"Audience","\u002Fdocs\u002Faudience","docs\u002F3.audience",[41,45,49,53,57,61],{"title":42,"path":43,"stem":44},"Contacts","\u002Fdocs\u002Faudience\u002Fcontacts","docs\u002F3.audience\u002F1.contacts",{"title":46,"path":47,"stem":48},"Import contacts","\u002Fdocs\u002Faudience\u002Fimport","docs\u002F3.audience\u002F2.import",{"title":50,"path":51,"stem":52},"Lists","\u002Fdocs\u002Faudience\u002Flists","docs\u002F3.audience\u002F3.lists",{"title":54,"path":55,"stem":56},"Segments","\u002Fdocs\u002Faudience\u002Fsegments","docs\u002F3.audience\u002F4.segments",{"title":58,"path":59,"stem":60},"Signup forms","\u002Fdocs\u002Faudience\u002Fsignup-forms","docs\u002F3.audience\u002F5.signup-forms",{"title":62,"path":63,"stem":64},"Unsubscribe and preferences","\u002Fdocs\u002Faudience\u002Funsubscribe-and-preferences","docs\u002F3.audience\u002F6.unsubscribe-and-preferences",{"title":66,"path":67,"stem":68,"children":69,"page":22},"Sending emails","\u002Fdocs\u002Femails","docs\u002F4.emails",[70,74,78,82],{"title":71,"path":72,"stem":73},"Writing emails","\u002Fdocs\u002Femails\u002Fwriting-emails","docs\u002F4.emails\u002F1.writing-emails",{"title":75,"path":76,"stem":77},"Campaigns","\u002Fdocs\u002Femails\u002Fcampaigns","docs\u002F4.emails\u002F2.campaigns",{"title":79,"path":80,"stem":81},"Flows","\u002Fdocs\u002Femails\u002Fflows","docs\u002F4.emails\u002F3.flows",{"title":83,"path":84,"stem":85},"Transactional emails","\u002Fdocs\u002Femails\u002Ftransactional","docs\u002F4.emails\u002F4.transactional",{"title":87,"path":88,"stem":89,"children":90,"page":22},"Deliverability","\u002Fdocs\u002Fdeliverability","docs\u002F5.deliverability",[91,95,99,103,107,111],{"title":92,"path":93,"stem":94},"Overview","\u002Fdocs\u002Fdeliverability\u002Foverview","docs\u002F5.deliverability\u002F1.overview",{"title":96,"path":97,"stem":98},"Warm-up","\u002Fdocs\u002Fdeliverability\u002Fwarm-up","docs\u002F5.deliverability\u002F2.warm-up",{"title":100,"path":101,"stem":102},"Contacts under review","\u002Fdocs\u002Fdeliverability\u002Fimported-contacts","docs\u002F5.deliverability\u002F3.imported-contacts",{"title":104,"path":105,"stem":106},"Reputation","\u002Fdocs\u002Fdeliverability\u002Freputation","docs\u002F5.deliverability\u002F4.reputation",{"title":108,"path":109,"stem":110},"Bounces and suppressions","\u002Fdocs\u002Fdeliverability\u002Fbounces-and-suppressions","docs\u002F5.deliverability\u002F5.bounces-and-suppressions",{"title":112,"path":113,"stem":114},"Deliverability report","\u002Fdocs\u002Fdeliverability\u002Fdeliverability-report","docs\u002F5.deliverability\u002F6.deliverability-report",{"title":116,"path":117,"stem":118,"children":119,"page":22},"AI","\u002Fdocs\u002Fai","docs\u002F6.ai",[120,124],{"title":121,"path":122,"stem":123},"Assistant","\u002Fdocs\u002Fai\u002Fassistant","docs\u002F6.ai\u002F1.assistant",{"title":125,"path":126,"stem":127},"Connect your agent (MCP)","\u002Fdocs\u002Fai\u002Fmcp","docs\u002F6.ai\u002F2.mcp",{"title":129,"path":130,"stem":131,"children":132,"page":22},"API reference","\u002Fdocs\u002Fapi","docs\u002F7.api",[133,137,141,145,148,152,156,160,164,168],{"title":134,"path":135,"stem":136},"Introduction","\u002Fdocs\u002Fapi\u002Fintroduction","docs\u002F7.api\u002F01.introduction",{"title":138,"path":139,"stem":140},"Emails","\u002Fdocs\u002Fapi\u002Femails","docs\u002F7.api\u002F02.emails",{"title":142,"path":143,"stem":144},"Templates","\u002Fdocs\u002Fapi\u002Ftemplates","docs\u002F7.api\u002F03.templates",{"title":42,"path":146,"stem":147},"\u002Fdocs\u002Fapi\u002Fcontacts","docs\u002F7.api\u002F04.contacts",{"title":149,"path":150,"stem":151},"Events","\u002Fdocs\u002Fapi\u002Fevents","docs\u002F7.api\u002F05.events",{"title":153,"path":154,"stem":155},"Lists and segments","\u002Fdocs\u002Fapi\u002Flists-and-segments","docs\u002F7.api\u002F06.lists-and-segments",{"title":157,"path":158,"stem":159},"Campaigns and flows","\u002Fdocs\u002Fapi\u002Fcampaigns-and-flows","docs\u002F7.api\u002F07.campaigns-and-flows",{"title":161,"path":162,"stem":163},"Domains and suppressions","\u002Fdocs\u002Fapi\u002Fdomains-and-suppressions","docs\u002F7.api\u002F08.domains-and-suppressions",{"title":165,"path":166,"stem":167},"Spaces","\u002Fdocs\u002Fapi\u002Fspaces","docs\u002F7.api\u002F09.spaces",{"title":169,"path":170,"stem":171},"Webhooks","\u002Fdocs\u002Fapi\u002Fwebhooks","docs\u002F7.api\u002F10.webhooks",{"title":173,"path":174,"stem":175,"children":176,"page":22},"Account & billing","\u002Fdocs\u002Faccount","docs\u002F8.account",[177,181],{"title":178,"path":179,"stem":180},"Spaces and members","\u002Fdocs\u002Faccount\u002Fspaces-and-members","docs\u002F8.account\u002F1.spaces-and-members",{"title":182,"path":183,"stem":184},"Billing","\u002Fdocs\u002Faccount\u002Fbilling","docs\u002F8.account\u002F2.billing",{"title":186,"path":187,"stem":188,"children":189,"page":22},"Guides","\u002Fdocs\u002Fguides","docs\u002F9.guides",[190,194,198],{"title":191,"path":192,"stem":193},"Welcome new subscribers","\u002Fdocs\u002Fguides\u002Fwelcome-sequence","docs\u002F9.guides\u002F1.welcome-sequence",{"title":195,"path":196,"stem":197},"Onboarding with events","\u002Fdocs\u002Fguides\u002Fonboarding-with-events","docs\u002F9.guides\u002F2.onboarding-with-events",{"title":199,"path":200,"stem":201},"Migrate from another tool","\u002Fdocs\u002Fguides\u002Fmigrate-from-another-tool","docs\u002F9.guides\u002F3.migrate-from-another-tool",{"id":203,"title":42,"body":204,"description":687,"extension":688,"links":689,"meta":690,"navigation":691,"path":43,"seo":692,"stem":44,"__hash__":693},"docs\u002Fdocs\u002F3.audience\u002F1.contacts.md",{"type":205,"value":206,"toc":675},"minimark",[207,211,214,219,317,331,334,377,388,392,395,463,468,477,481,484,561,570,574,588,591,612,615,619,625,632,642,646],[208,209,210],"p",{},"A contact is one email address in a space, with a name and the attributes you choose. Contacts are unlimited on every plan.",[208,212,213],{},"Two spaces never share contacts. The same address in two spaces is two separate contacts, each with its own lists and history.",[215,216,218],"h2",{"id":217},"what-a-contact-holds","What a contact holds",[220,221,222,235],"table",{},[223,224,225],"thead",{},[226,227,228,232],"tr",{},[229,230,231],"th",{},"Field",[229,233,234],{},"Notes",[236,237,238,250,264,285,294,308],"tbody",{},[226,239,240,247],{},[241,242,243],"td",{},[244,245,246],"strong",{},"Email",[241,248,249],{},"Unique in the space. Stored in lowercase.",[226,251,252,261],{},[241,253,254,257,258],{},[244,255,256],{},"First name",", ",[244,259,260],{},"Last name",[241,262,263],{},"Optional, up to 120 characters each.",[226,265,266,271],{},[241,267,268],{},[244,269,270],{},"Attributes",[241,272,273,274,257,278,257,281,284],{},"Your own data: ",[275,276,277],"code",{},"plan",[275,279,280],{},"company",[275,282,283],{},"signup_date","… See below.",[226,286,287,291],{},[241,288,289],{},[244,290,50],{},[241,292,293],{},"The lists the contact is subscribed to, with the status of each subscription.",[226,295,296,300],{},[241,297,298],{},[244,299,149],{},[241,301,302,303,307],{},"What the contact did in your product, sent by your app. ",[304,305,306],"a",{"href":150},"Events API",".",[226,309,310,314],{},[241,311,312],{},[244,313,138],{},[241,315,316],{},"Every email sent to this contact and what happened to it.",[208,318,319,320,323,324,327,328,307],{},"Kula also records the ",[244,321,322],{},"mailbox provider"," of each address (Google, Microsoft, Yahoo, AOL, Apple or other), read from the DNS of its domain. A company address hosted on Google Workspace counts as Google. The provider feeds the ",[304,325,326],{"href":113},"deliverability report"," and can be used in ",[304,329,330],{"href":55},"segments",[215,332,270],{"id":333},"attributes",[335,336,337,341,351,364],"ul",{},[338,339,340],"li",{},"Up to 50 attributes per contact.",[338,342,343,344,257,346,257,348,307],{},"Keys use lowercase letters, digits and underscores, up to 50 characters: ",[275,345,277],{},[275,347,283],{},[275,349,350],{},"trial_ends_at",[338,352,353,257,356,359,360,363],{},[275,354,355],{},"email",[275,357,358],{},"first_name"," and ",[275,361,362],{},"last_name"," are reserved.",[338,365,366,367,257,370,257,373,376],{},"Text values are limited to 1,000 characters. Numbers, booleans and dates sent through the API keep their type, so segments can compare them (",[275,368,369],{},"greater_than",[275,371,372],{},"is_true",[275,374,375],{},"before","…).",[208,378,379,380,383,384,307],{},"Use an attribute in an email with ",[275,381,382],{},"{{ contact.plan }}",". ",[304,385,387],{"href":386},"\u002Fdocs\u002Femails\u002Fwriting-emails#variables","All variables",[215,389,391],{"id":390},"status","Status",[208,393,394],{},"The status decides whether a contact can receive marketing emails.",[220,396,397,409],{},[223,398,399],{},[226,400,401,403,406],{},[229,402,391],{},[229,404,405],{},"Meaning",[229,407,408],{},"How it gets there",[236,410,411,424,437,450],{},[226,412,413,418,421],{},[241,414,415],{},[244,416,417],{},"Active",[241,419,420],{},"Can receive emails",[241,422,423],{},"Default",[226,425,426,431,434],{},[241,427,428],{},[244,429,430],{},"Unsubscribed",[241,432,433],{},"Left every list",[241,435,436],{},"Clicked \"Unsubscribe from all\" on the preferences page, or you unsubscribed them",[226,438,439,444,447],{},[241,440,441],{},[244,442,443],{},"Bounced",[241,445,446],{},"The address does not accept email",[241,448,449],{},"A permanent bounce, or three temporary bounces in a row",[226,451,452,457,460],{},[241,453,454],{},[244,455,456],{},"Complained",[241,458,459],{},"Reported one of your emails as spam",[241,461,462],{},"A complaint from the mailbox provider",[208,464,465,466,307],{},"A bounced or complained contact stays in your space for history, but Kula refuses to subscribe it again, from a form, an import or the API. ",[304,467,108],{"href":109},[469,470,471],"note",{},[208,472,473,474,476],{},"Unsubscribing from a single list does not change the status: the contact stays ",[244,475,417],{}," and keeps receiving the other lists it is subscribed to.",[215,478,480],{"id":479},"where-contacts-come-from","Where contacts come from",[208,482,483],{},"The contact page shows how each contact was added:",[220,485,486,496],{},[223,487,488],{},[226,489,490,493],{},[229,491,492],{},"Source",[229,494,495],{},"Added by",[236,497,498,511,524,538,551],{},[226,499,500,505],{},[241,501,502],{},[244,503,504],{},"Signup form",[241,506,507,508],{},"A visitor who filled one of your ",[304,509,510],{"href":59},"signup forms",[226,512,513,518],{},[241,514,515],{},[244,516,517],{},"API",[241,519,520,521],{},"Your app, through the ",[304,522,523],{"href":146},"contacts API",[226,525,526,531],{},[241,527,528],{},[244,529,530],{},"Import",[241,532,533,534,537],{},"A ",[304,535,536],{"href":47},"CSV import"," or the bulk import API",[226,539,540,545],{},[241,541,542],{},[244,543,544],{},"Dashboard",[241,546,547,548],{},"A member, with ",[244,549,550],{},"Add contact",[226,552,553,558],{},[241,554,555],{},[244,556,557],{},"AI assistant",[241,559,560],{},"An AI assistant acting for a member",[208,562,563,564,567,568,307],{},"Contacts who have never opened, clicked or confirmed their subscription are marked ",[244,565,566],{},"Under review",": they receive a capped share of each campaign until results are healthy. ",[304,569,100],{"href":101},[215,571,573],{"id":572},"the-contacts-page","The Contacts page",[208,575,576,578,579,257,581,584,585,587],{},[244,577,42],{}," lists everyone in the space, with counters for ",[244,580,417],{},[244,582,583],{},"Unreachable"," (unsubscribed, bounced or complained) and ",[244,586,566],{},". Filter by list, segment, status or source, or search by email and name.",[208,589,590],{},"Open a contact to see its details, attributes, lists, events and emails. From there you can:",[335,592,593,596,603,609],{},[338,594,595],{},"edit the name and attributes;",[338,597,598,599,602],{},"subscribe it to a list, or ",[244,600,601],{},"Resubscribe"," it to a list it left (only do this if the person asked you to);",[338,604,605,608],{},[244,606,607],{},"Unsubscribe from everything",";",[338,610,611],{},"delete it for good.",[208,613,614],{},"To stop emailing someone, unsubscribe them instead: a deleted address could be added again by an import.",[215,616,618],{"id":617},"delete-a-contact","Delete a contact",[208,620,621,624],{},[244,622,623],{},"Delete"," removes the contact with its subscriptions and events. Its sent emails stay in your reports without the address. If the address is suppressed, it stays suppressed: Kula won't email it again, even if it comes back in an import.",[208,626,627,628,631],{},"For a data deletion request, admins can tick ",[244,629,630],{},"Erase every trace",": the address also leaves your suppression list, and Kula forgets it entirely.",[208,633,634,635,638,639,641],{},"To clean up your list, ",[244,636,637],{},"Delete unreachable"," on the ",[244,640,42],{}," page deletes every bounced and complained contact at once. Their addresses stay suppressed. Unsubscribed contacts are kept: they're what stops a later import from subscribing them again.",[215,643,645],{"id":644},"related","Related",[647,648,649,656,662,668],"card-group",{},[650,651,653],"card",{"icon":652,"title":46,"to":47},"i-mingcute-file-import-fill",[208,654,655],{},"A CSV file from another tool",[650,657,659],{"icon":658,"title":50,"to":51},"i-mingcute-list-check-fill",[208,660,661],{},"What people subscribe to",[650,663,665],{"icon":664,"title":54,"to":55},"i-mingcute-filter-fill",[208,666,667],{},"Filters on attributes, events and activity",[650,669,672],{"icon":670,"title":671,"to":146},"i-mingcute-code-fill","Contacts API",[208,673,674],{},"Create and update contacts from your app",{"title":676,"searchDepth":677,"depth":678,"links":679},"",1,2,[680,681,682,683,684,685,686],{"id":217,"depth":678,"text":218},{"id":333,"depth":678,"text":270},{"id":390,"depth":678,"text":391},{"id":479,"depth":678,"text":480},{"id":572,"depth":678,"text":573},{"id":617,"depth":678,"text":618},{"id":644,"depth":678,"text":645},"Contact fields, attributes, statuses and sources","md",null,{},true,{"title":42,"description":687},"_SvifYFgGjdEx1Jd1tRA4J26CA_gt595kF7GD6orAJk",[695,697],{"title":33,"path":34,"stem":35,"description":696,"children":-1},"Fix a DNS check that stays pending or fails",{"title":46,"path":47,"stem":48,"description":698,"children":-1},"Import your list from another tool with a CSV file",1792265663063]