[{"data":1,"prerenderedAt":537},["ShallowReactive",2],{"doc-article-contacts-manage-contacts":3,"doc-siblings-contacts":535},{"_path":4,"_dir":5,"_draft":6,"_partial":6,"_locale":7,"title":8,"description":9,"category":5,"order":10,"difficulty":11,"time_to_complete":12,"related":13,"code_curl":16,"code_node":17,"code_python":18,"code_go":19,"body":20,"_type":529,"_id":530,"_source":531,"_file":532,"_stem":533,"_extension":534},"\u002Fdeveloper\u002Fcontacts\u002Fmanage-contacts","contacts",false,"","Manage Contacts","Synchronize customer contacts, sync custom fields metadata, and retrieve profile lists dynamically.",1,"intermediate","5 minutes",[14,15],"\u002Fdocs\u002Fgetting-started\u002Fintroduction","\u002Fdocs\u002Fmessaging\u002Fsend-text","# Create a new customer contact entry\ncurl -X POST \"https:\u002F\u002Fapi.aisoule.com\u002Fv1\u002Fcontacts\" \\\n  -H \"Authorization: Bearer YOUR_API_KEY\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\n    \"phone\": \"918856879188\",\n    \"first_name\": \"Priya\",\n    \"last_name\": \"Sharma\",\n    \"email\": \"priya@example.com\",\n    \"tags\": [\"Lead\", \"High-Priority\"],\n    \"custom_fields\": {\n      \"shopify_id\": \"cust_29813a\",\n      \"acquisition_source\": \"AdWords\"\n    }\n  }'\n","\u002F\u002F Sync contact record via NodeJS\nconst axios = require('axios');\n\naxios.post('https:\u002F\u002Fapi.aisoule.com\u002Fv1\u002Fcontacts', {\n  phone: '918856879188',\n  first_name: 'Priya',\n  last_name: 'Sharma',\n  email: 'priya@example.com',\n  tags: ['Lead'],\n  custom_fields: { shopify_id: 'cust_29813a' }\n}, {\n  headers: { 'Authorization': 'Bearer YOUR_API_KEY' }\n})\n.then(res => console.log('Contact Synced. ID:', res.data.contact.id))\n.catch(err => console.error('Contact Sync Error:', err.message));\n","# Create contact entry in Python\nimport requests\n\npayload = {\n    \"phone\": \"918856879188\",\n    \"first_name\": \"Priya\",\n    \"last_name\": \"Sharma\",\n    \"email\": \"priya@example.com\",\n    \"tags\": [\"Lead\"],\n    \"custom_fields\": { \"shopify_id\": \"cust_29813a\" }\n}\nheaders = {\n    \"Authorization\": \"Bearer YOUR_API_KEY\",\n    \"Content-Type\": \"application\u002Fjson\"\n}\nres = requests.post(\"https:\u002F\u002Fapi.aisoule.com\u002Fv1\u002Fcontacts\", json=payload, headers=headers)\nprint(\"Contact details:\", res.json())\n","\u002F\u002F Create contact in Go\npackage main\n\nimport (\n    \"bytes\"\n    \"fmt\"\n    \"net\u002Fhttp\"\n    \"io\"\n)\n\nfunc main() {\n    jsonStr := []byte(`{\n        \"phone\": \"918856879188\",\n        \"first_name\": \"Priya\",\n        \"email\": \"priya@example.com\",\n        \"tags\": [\"Lead\"]\n    }`)\n    req, _ := http.NewRequest(\"POST\", \"https:\u002F\u002Fapi.aisoule.com\u002Fv1\u002Fcontacts\", bytes.NewBuffer(jsonStr))\n    req.Header.Set(\"Authorization\", \"Bearer YOUR_API_KEY\")\n    req.Header.Set(\"Content-Type\", \"application\u002Fjson\")\n    \n    client := &http.Client{}\n    resp, _ := client.Do(req)\n    defer resp.Body.Close()\n    \n    body, _ := io.ReadAll(resp.Body)\n    fmt.Println(\"Synced:\", string(body))\n}\n",{"type":21,"children":22,"toc":515},"root",[23,32,38,42,49,54,61,74,80,325,328,334,339,344,353,359,490,504],{"type":24,"tag":25,"props":26,"children":28},"element","h1",{"id":27},"contacts-management-api",[29],{"type":30,"value":31},"text","Contacts Management API",{"type":24,"tag":33,"props":34,"children":35},"p",{},[36],{"type":30,"value":37},"Synchronize customer details, apply grouping tags, and store custom metadata parameters to coordinate campaigns. Custom fields are reactive and can be queried directly inside the Bot Flow Builder logic nodes.",{"type":24,"tag":39,"props":40,"children":41},"hr",{},[],{"type":24,"tag":43,"props":44,"children":46},"h2",{"id":45},"_1-create-or-update-contact",[47],{"type":30,"value":48},"1. Create or Update Contact",{"type":24,"tag":33,"props":50,"children":51},{},[52],{"type":30,"value":53},"Create a new contact card or update an existing contact dynamically if the phone number already exists.",{"type":24,"tag":55,"props":56,"children":58},"h3",{"id":57},"endpoint",[59],{"type":30,"value":60},"Endpoint",{"type":24,"tag":62,"props":63,"children":68},"pre",{"className":64,"code":66,"language":67,"meta":7},[65],"language-http","POST \u002Fv1\u002Fcontacts\n","http",[69],{"type":24,"tag":70,"props":71,"children":72},"code",{"__ignoreMap":7},[73],{"type":30,"value":66},{"type":24,"tag":55,"props":75,"children":77},{"id":76},"payload-parameters",[78],{"type":30,"value":79},"Payload Parameters",{"type":24,"tag":81,"props":82,"children":83},"table",{},[84,114],{"type":24,"tag":85,"props":86,"children":87},"thead",{},[88],{"type":24,"tag":89,"props":90,"children":91},"tr",{},[92,99,104,109],{"type":24,"tag":93,"props":94,"children":96},"th",{"align":95},"left",[97],{"type":30,"value":98},"Parameter",{"type":24,"tag":93,"props":100,"children":101},{"align":95},[102],{"type":30,"value":103},"Type",{"type":24,"tag":93,"props":105,"children":106},{"align":95},[107],{"type":30,"value":108},"Required",{"type":24,"tag":93,"props":110,"children":111},{"align":95},[112],{"type":30,"value":113},"Description",{"type":24,"tag":115,"props":116,"children":117},"tbody",{},[118,162,192,221,250,288],{"type":24,"tag":89,"props":119,"children":120},{},[121,131,140,149],{"type":24,"tag":122,"props":123,"children":124},"td",{"align":95},[125],{"type":24,"tag":70,"props":126,"children":128},{"className":127},[],[129],{"type":30,"value":130},"phone",{"type":24,"tag":122,"props":132,"children":133},{"align":95},[134],{"type":24,"tag":70,"props":135,"children":137},{"className":136},[],[138],{"type":30,"value":139},"string",{"type":24,"tag":122,"props":141,"children":142},{"align":95},[143],{"type":24,"tag":144,"props":145,"children":146},"strong",{},[147],{"type":30,"value":148},"Yes",{"type":24,"tag":122,"props":150,"children":151},{"align":95},[152,154,160],{"type":30,"value":153},"Destination mobile number, formatted with country code prefix (e.g. ",{"type":24,"tag":70,"props":155,"children":157},{"className":156},[],[158],{"type":30,"value":159},"918856879188",{"type":30,"value":161},", no spaces or symbols).",{"type":24,"tag":89,"props":163,"children":164},{},[165,174,182,187],{"type":24,"tag":122,"props":166,"children":167},{"align":95},[168],{"type":24,"tag":70,"props":169,"children":171},{"className":170},[],[172],{"type":30,"value":173},"first_name",{"type":24,"tag":122,"props":175,"children":176},{"align":95},[177],{"type":24,"tag":70,"props":178,"children":180},{"className":179},[],[181],{"type":30,"value":139},{"type":24,"tag":122,"props":183,"children":184},{"align":95},[185],{"type":30,"value":186},"No",{"type":24,"tag":122,"props":188,"children":189},{"align":95},[190],{"type":30,"value":191},"Customer's first name.",{"type":24,"tag":89,"props":193,"children":194},{},[195,204,212,216],{"type":24,"tag":122,"props":196,"children":197},{"align":95},[198],{"type":24,"tag":70,"props":199,"children":201},{"className":200},[],[202],{"type":30,"value":203},"last_name",{"type":24,"tag":122,"props":205,"children":206},{"align":95},[207],{"type":24,"tag":70,"props":208,"children":210},{"className":209},[],[211],{"type":30,"value":139},{"type":24,"tag":122,"props":213,"children":214},{"align":95},[215],{"type":30,"value":186},{"type":24,"tag":122,"props":217,"children":218},{"align":95},[219],{"type":30,"value":220},"Customer's last name.",{"type":24,"tag":89,"props":222,"children":223},{},[224,233,241,245],{"type":24,"tag":122,"props":225,"children":226},{"align":95},[227],{"type":24,"tag":70,"props":228,"children":230},{"className":229},[],[231],{"type":30,"value":232},"email",{"type":24,"tag":122,"props":234,"children":235},{"align":95},[236],{"type":24,"tag":70,"props":237,"children":239},{"className":238},[],[240],{"type":30,"value":139},{"type":24,"tag":122,"props":242,"children":243},{"align":95},[244],{"type":30,"value":186},{"type":24,"tag":122,"props":246,"children":247},{"align":95},[248],{"type":30,"value":249},"Valid email address.",{"type":24,"tag":89,"props":251,"children":252},{},[253,262,271,275],{"type":24,"tag":122,"props":254,"children":255},{"align":95},[256],{"type":24,"tag":70,"props":257,"children":259},{"className":258},[],[260],{"type":30,"value":261},"tags",{"type":24,"tag":122,"props":263,"children":264},{"align":95},[265],{"type":24,"tag":70,"props":266,"children":268},{"className":267},[],[269],{"type":30,"value":270},"array",{"type":24,"tag":122,"props":272,"children":273},{"align":95},[274],{"type":30,"value":186},{"type":24,"tag":122,"props":276,"children":277},{"align":95},[278,280,286],{"type":30,"value":279},"List of grouping labels (e.g. ",{"type":24,"tag":70,"props":281,"children":283},{"className":282},[],[284],{"type":30,"value":285},"[\"VIP\", \"Lead\"]",{"type":30,"value":287},").",{"type":24,"tag":89,"props":289,"children":290},{},[291,300,309,313],{"type":24,"tag":122,"props":292,"children":293},{"align":95},[294],{"type":24,"tag":70,"props":295,"children":297},{"className":296},[],[298],{"type":30,"value":299},"custom_fields",{"type":24,"tag":122,"props":301,"children":302},{"align":95},[303],{"type":24,"tag":70,"props":304,"children":306},{"className":305},[],[307],{"type":30,"value":308},"object",{"type":24,"tag":122,"props":310,"children":311},{"align":95},[312],{"type":30,"value":186},{"type":24,"tag":122,"props":314,"children":315},{"align":95},[316,318,324],{"type":30,"value":317},"Key-value dictionary containing custom attributes (e.g. ",{"type":24,"tag":70,"props":319,"children":321},{"className":320},[],[322],{"type":30,"value":323},"{\"shopify_id\": \"cust_29813a\"}",{"type":30,"value":287},{"type":24,"tag":39,"props":326,"children":327},{},[],{"type":24,"tag":43,"props":329,"children":331},{"id":330},"_2-retrieve-contacts-list",[332],{"type":30,"value":333},"2. Retrieve Contacts List",{"type":24,"tag":33,"props":335,"children":336},{},[337],{"type":30,"value":338},"Fetch segmented lists of synced contacts, complete with pagination support.",{"type":24,"tag":55,"props":340,"children":342},{"id":341},"endpoint-1",[343],{"type":30,"value":60},{"type":24,"tag":62,"props":345,"children":348},{"className":346,"code":347,"language":67,"meta":7},[65],"GET \u002Fv1\u002Fcontacts\n",[349],{"type":24,"tag":70,"props":350,"children":351},{"__ignoreMap":7},[352],{"type":30,"value":347},{"type":24,"tag":55,"props":354,"children":356},{"id":355},"query-parameters",[357],{"type":30,"value":358},"Query Parameters",{"type":24,"tag":81,"props":360,"children":361},{},[362,384],{"type":24,"tag":85,"props":363,"children":364},{},[365],{"type":24,"tag":89,"props":366,"children":367},{},[368,372,376,380],{"type":24,"tag":93,"props":369,"children":370},{"align":95},[371],{"type":30,"value":98},{"type":24,"tag":93,"props":373,"children":374},{"align":95},[375],{"type":30,"value":103},{"type":24,"tag":93,"props":377,"children":378},{"align":95},[379],{"type":30,"value":108},{"type":24,"tag":93,"props":381,"children":382},{"align":95},[383],{"type":30,"value":113},{"type":24,"tag":115,"props":385,"children":386},{},[387,432,461],{"type":24,"tag":89,"props":388,"children":389},{},[390,399,408,412],{"type":24,"tag":122,"props":391,"children":392},{"align":95},[393],{"type":24,"tag":70,"props":394,"children":396},{"className":395},[],[397],{"type":30,"value":398},"limit",{"type":24,"tag":122,"props":400,"children":401},{"align":95},[402],{"type":24,"tag":70,"props":403,"children":405},{"className":404},[],[406],{"type":30,"value":407},"integer",{"type":24,"tag":122,"props":409,"children":410},{"align":95},[411],{"type":30,"value":186},{"type":24,"tag":122,"props":413,"children":414},{"align":95},[415,417,423,425,431],{"type":30,"value":416},"Number of records to return (Default: ",{"type":24,"tag":70,"props":418,"children":420},{"className":419},[],[421],{"type":30,"value":422},"20",{"type":30,"value":424},", Max: ",{"type":24,"tag":70,"props":426,"children":428},{"className":427},[],[429],{"type":30,"value":430},"100",{"type":30,"value":287},{"type":24,"tag":89,"props":433,"children":434},{},[435,444,452,456],{"type":24,"tag":122,"props":436,"children":437},{"align":95},[438],{"type":24,"tag":70,"props":439,"children":441},{"className":440},[],[442],{"type":30,"value":443},"offset",{"type":24,"tag":122,"props":445,"children":446},{"align":95},[447],{"type":24,"tag":70,"props":448,"children":450},{"className":449},[],[451],{"type":30,"value":407},{"type":24,"tag":122,"props":453,"children":454},{"align":95},[455],{"type":30,"value":186},{"type":24,"tag":122,"props":457,"children":458},{"align":95},[459],{"type":30,"value":460},"Number of records to skip (for paging).",{"type":24,"tag":89,"props":462,"children":463},{},[464,473,481,485],{"type":24,"tag":122,"props":465,"children":466},{"align":95},[467],{"type":24,"tag":70,"props":468,"children":470},{"className":469},[],[471],{"type":30,"value":472},"tag",{"type":24,"tag":122,"props":474,"children":475},{"align":95},[476],{"type":24,"tag":70,"props":477,"children":479},{"className":478},[],[480],{"type":30,"value":139},{"type":24,"tag":122,"props":482,"children":483},{"align":95},[484],{"type":30,"value":186},{"type":24,"tag":122,"props":486,"children":487},{"align":95},[488],{"type":30,"value":489},"Filter contacts matching a specific tag parameter.",{"type":24,"tag":55,"props":491,"children":493},{"id":492},"response-200-ok",[494,496,502],{"type":30,"value":495},"Response (",{"type":24,"tag":70,"props":497,"children":499},{"className":498},[],[500],{"type":30,"value":501},"200 OK",{"type":30,"value":503},")",{"type":24,"tag":62,"props":505,"children":510},{"className":506,"code":508,"language":509,"meta":7},[507],"language-json","{\n  \"success\": true,\n  \"contacts\": [\n    {\n      \"id\": \"cnt_918856879188\",\n      \"phone\": \"918856879188\",\n      \"first_name\": \"Priya\",\n      \"last_name\": \"Sharma\",\n      \"email\": \"priya@example.com\",\n      \"tags\": [\"Lead\"],\n      \"created_at\": \"2026-06-02T08:00:00Z\"\n    }\n  ],\n  \"pagination\": {\n    \"total\": 1,\n    \"limit\": 20,\n    \"offset\": 0\n  }\n}\n","json",[511],{"type":24,"tag":70,"props":512,"children":513},{"__ignoreMap":7},[514],{"type":30,"value":508},{"title":7,"searchDepth":516,"depth":516,"links":517},2,[518,523],{"id":45,"depth":516,"text":48,"children":519},[520,522],{"id":57,"depth":521,"text":60},3,{"id":76,"depth":521,"text":79},{"id":330,"depth":516,"text":333,"children":524},[525,526,527],{"id":341,"depth":521,"text":60},{"id":355,"depth":521,"text":358},{"id":492,"depth":521,"text":528},"Response (200 OK)","markdown","content:developer:contacts:manage-contacts.md","content","developer\u002Fcontacts\u002Fmanage-contacts.md","developer\u002Fcontacts\u002Fmanage-contacts","md",[536],{"_path":4,"title":8},1780423178968]