The Create Client endpoint lets you add clients directly to your AgencyHandy workspace from an external system. Unlike leads, clients are fully onboarded contacts who can be assigned to orders, invoices, and projects. Use this endpoint to sync new clients from a CRM, onboarding form, or any other data source.
Before using this endpoint, complete the Getting Started guide to obtain your API key. You do not need to send a company ID or role ID. AgencyHandy assigns the client to the workspace client role automatically.
Prerequisites
✅ API key generated from Workspace Config → API Key
Endpoint
POST {{URL}}/members/bulk-client
Headers
Header
Value
x-api-key
Your API key
Content-Type
application/json
Request body
The request body is a JSON array. You can create one or more clients in a single request.
string
必填
The client’s email address. It must be valid and should be unique within your workspace.
string
必填
The client’s first name.
string
必填
The client’s last name.
string
必填
The client’s status. The only accepted value for this endpoint is Client.
string
Optional password for the client. If provided, it must contain at least 8 characters, one uppercase letter, one lowercase letter, one number, and one special character.
string
The client’s phone number. Optional. Defaults to an empty string if omitted.
string
The client’s country. Optional.
string
The client’s city. Optional.
string
The client’s state or region. Optional.
string
The client’s ZIP or postal code. Optional.
string
The client’s address. Optional.
string[]
Optional array of category or label IDs. Each ID must exist in the workspace.
string
The client’s company name. Optional.
boolean
Whether to send an invitation email. Optional. Defaults to true.
string
How you acquired this client. Optional. Example values: website, referral, social.
string
The estimated value associated with the client. Optional.
string
The client’s website. Optional.
string
Optional assigned agent ID.
string
Optional date for when the client was last contacted.
string[]
Optional array of file IDs attached to the client.
string
Optional profile image URL or file reference.
array
Optional custom field responses for client custom fields.
Do not send companyId, role, isConvertedClient, or positionInBoard. The endpoint does not use those request fields. Unknown fields are removed during validation.
Full payload example
Only email, firstName, lastName, and status are required. Every other field shown here is optional.
Clients that were created, restored, or converted from existing leads.
string
Unique ID of the newly created client. Use this ID when assigning the client to orders or invoices via the API.
string
The full name of the client (firstName + lastName).
string
The status of the client as stored.
array
Clients that were not created. Each item includes the submitted email and a reason, such as Client already exists or One or more category not found.
You can pass up to 200 client objects in the array. If a submitted email belongs to an existing lead, AgencyHandy converts that lead into a client.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"AgencyHandy","description":"AgencyHandy documentation — learn how to manage clients, orders, invoices, and your team from a single platform.","colors":{"primary":"#6C5CE7","light":"#EDE9FF","dark":"#4B3CC7"},"logo":{"light":"https://mintcdn.com/agencyhandy-36ccbd64/zJLfimHmfDAoxavv/logo/agencyhandy-light.png?fit=max\u0026auto=format\u0026n=zJLfimHmfDAoxavv\u0026q=85\u0026s=4f7abbc6052d4ca949dd929c3b6e3c00","dark":"https://mintcdn.com/agencyhandy-36ccbd64/zJLfimHmfDAoxavv/logo/agencyhandy-dark.png?fit=max\u0026auto=format\u0026n=zJLfimHmfDAoxavv\u0026q=85\u0026s=78a129bd7795c71a56264bf72aaf1ae5"},"favicon":"https://mintcdn.com/agencyhandy-36ccbd64/c35g48MdcWqLJ2sp/favicon.ico?fit=max\u0026auto=format\u0026n=c35g48MdcWqLJ2sp\u0026q=85\u0026s=6c2658a03265b8a07e0acd74d52f9834","navbar":{"links":[],"primary":{"type":"button","label":"Sign In","href":"https://app.agencyhandy.com"}},"footer":{"socials":{"x":"https://x.com/agencyhandy","linkedin":"https://linkedin.com/company/agency-handy"}},"icons":{"library":"lucide"},"styling":{"eyebrows":"breadcrumbs","latex":true},"contextual":{"options":["copy","view","chatgpt","claude"],"display":"header"},"navigation":{"directory":"card","languages":[{"language":"en","default":true,"navbar":{"links":[],"primary":{"type":"button","label":"Sign In","href":"https://app.agencyhandy.com"}},"href":"getting-started/introduction"},{"language":"fr","navbar":{"links":[],"primary":{"type":"button","label":"Se connecter","href":"https://app.agencyhandy.com"}},"href":"fr/getting-started/introduction"},{"language":"es","navbar":{"links":[],"primary":{"type":"button","label":"Iniciar sesión","href":"https://app.agencyhandy.com"}},"href":"es/getting-started/introduction"},{"language":"zh","navbar":{"links":[],"primary":{"type":"button","label":"登录","href":"https://app.agencyhandy.com"}},"href":"zh/getting-started/introduction"},{"language":"zh-Hant","navbar":{"links":[],"primary":{"type":"button","label":"登入","href":"https://app.agencyhandy.com"}},"href":"zh-Hant/getting-started/introduction"},{"language":"de","navbar":{"links":[],"primary":{"type":"button","label":"Anmelden","href":"https://app.agencyhandy.com"}},"href":"de/getting-started/introduction"},{"language":"ko","navbar":{"links":[],"primary":{"type":"button","label":"로그인","href":"https://app.agencyhandy.com"}},"href":"ko/getting-started/introduction"},{"language":"cs","navbar":{"links":[],"primary":{"type":"button","label":"Přihlásit se","href":"https://app.agencyhandy.com"}},"href":"cs/getting-started/introduction"},{"language":"ja","navbar":{"links":[],"primary":{"type":"button","label":"サインイン","href":"https://app.agencyhandy.com"}},"href":"ja/getting-started/introduction"},{"language":"it","navbar":{"links":[],"primary":{"type":"button","label":"Accedi","href":"https://app.agencyhandy.com"}},"href":"it/getting-started/introduction"},{"language":"lv","navbar":{"links":[],"primary":{"type":"button","label":"Pierakstīties","href":"https://app.agencyhandy.com"}},"href":"lv/getting-started/introduction"},{"language":"no","navbar":{"links":[],"primary":{"type":"button","label":"Logg inn","href":"https://app.agencyhandy.com"}},"href":"no/getting-started/introduction"},{"language":"ar","navbar":{"links":[],"primary":{"type":"button","label":"تسجيل الدخول","href":"https://app.agencyhandy.com"}},"href":"ar/getting-started/introduction"},{"language":"sv","navbar":{"links":[],"primary":{"type":"button","label":"Logga in","href":"https://app.agencyhandy.com"}},"href":"sv/getting-started/introduction"},{"language":"da","navbar":{"links":[],"primary":{"type":"button","label":"Log ind","href":"https://app.agencyhandy.com"}},"href":"da/getting-started/introduction"},{"language":"pl","navbar":{"links":[],"primary":{"type":"button","label":"Zaloguj się","href":"https://app.agencyhandy.com"}},"href":"pl/getting-started/introduction"},{"language":"nl","navbar":{"links":[],"primary":{"type":"button","label":"Inloggen","href":"https://app.agencyhandy.com"}},"href":"nl/getting-started/introduction"},{"language":"tr","navbar":{"links":[],"primary":{"type":"button","label":"Giriş Yap","href":"https://app.agencyhandy.com"}},"href":"tr/getting-started/introduction"},{"language":"uz","navbar":{"links":[],"primary":{"type":"button","label":"Kirish","href":"https://app.agencyhandy.com"}},"href":"uz/getting-started/introduction"},{"language":"ru","navbar":{"links":[],"primary":{"type":"button","label":"Войти","href":"https://app.agencyhandy.com"}},"href":"ru/getting-started/introduction"},{"language":"pt","navbar":{"links":[],"primary":{"type":"button","label":"Iniciar Sessão","href":"https://app.agencyhandy.com"}},"href":"pt/getting-started/introduction"},{"language":"pt-BR","navbar":{"links":[],"primary":{"type":"button","label":"Entrar","href":"https://app.agencyhandy.com"}},"href":"pt-BR/getting-started/introduction"},{"language":"id","navbar":{"links":[],"primary":{"type":"button","label":"Masuk","href":"https://app.agencyhandy.com"}},"href":"id/getting-started/introduction"},{"language":"fi","navbar":{"links":[],"primary":{"type":"button","label":"Kirjaudu sisään","href":"https://app.agencyhandy.com"}},"href":"fi/getting-started/introduction"},{"language":"ro","navbar":{"links":[],"primary":{"type":"button","label":"Conectare","href":"https://app.agencyhandy.com"}},"href":"ro/getting-started/introduction"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"agencyhandy-36ccbd64","hasAudioNarration":false,"actualSubdomain":"agencyhandy-36ccbd64","customDomains":["docs.agencyhandy.com"],"gitSource":{"type":"github","owner":"agencyhandy","repo":"docs-starter","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6afb5cbe8ce30a6a0e19a187","clientVersion":"0.0.4205","searchFilterCounts":[{"language":"en","tag":"For Agency","count":41},{"language":"ar","tag":"للوكالة","count":41},{"language":"cs","tag":"Pro agentury","count":41},{"language":"da","tag":"For Bureau","count":41},{"language":"de","tag":"Für Agenturen","count":41},{"language":"es","tag":"Para la agencia","count":41},{"language":"fi","tag":"Toimistolle","count":41},{"language":"fr","tag":"Pour l'agence","count":41},{"language":"id","tag":"Untuk Agensi","count":41},{"language":"it","tag":"Per le Agenzie","count":41},{"language":"ja","tag":"エージェンシー向け","count":41},{"language":"ko","tag":"에이전시용","count":41},{"language":"lv","tag":"Aģentūrai","count":41},{"language":"nl","tag":"Voor Bureau","count":41},{"language":"no","tag":"For byrå","count":41},{"language":"pl","tag":"Dla Agencji","count":41},{"language":"pt-BR","tag":"Para Agências","count":41},{"language":"pt","tag":"Para Agências","count":41},{"language":"ro","tag":"Pentru Agenție","count":41},{"language":"ru","tag":"Для агентства","count":41},{"language":"sv","tag":"För Byrå","count":41},{"language":"tr","tag":"Ajans İçin","count":41},{"language":"uz","tag":"Agentlik uchun","count":41},{"language":"zh-Hant","tag":"適用於代理商","count":41},{"language":"zh","tag":"面向代理商","count":41},{"language":"en","tag":"For Client","count":10},{"language":"ar","tag":"للعميل","count":10},{"language":"cs","tag":"Pro klienty","count":10},{"language":"da","tag":"For Kunde","count":10},{"language":"de","tag":"Für Kunden","count":10},{"language":"es","tag":"Para el cliente","count":10},{"language":"fi","tag":"Asiakkaalle","count":10},{"language":"fr","tag":"Pour le client","count":10},{"language":"id","tag":"Untuk Klien","count":10},{"language":"it","tag":"Per il Cliente","count":10},{"language":"ja","tag":"クライアント向け","count":10},{"language":"ko","tag":"클라이언트용","count":10},{"language":"lv","tag":"Klientam","count":10},{"language":"nl","tag":"Voor Klant","count":10},{"language":"no","tag":"For klient","count":10},{"language":"pl","tag":"Dla Klienta","count":10},{"language":"pt-BR","tag":"Para Clientes","count":10},{"language":"pt","tag":"Para Clientes","count":10},{"language":"ro","tag":"Pentru Client","count":10},{"language":"ru","tag":"Для клиента","count":10},{"language":"sv","tag":"För Klient","count":10},{"language":"tr","tag":"Müşteri İçin","count":10},{"language":"uz","tag":"Mijoz uchun","count":10},{"language":"zh-Hant","tag":"適用於客戶","count":10},{"language":"zh","tag":"面向客户","count":10},{"language":"en","tag":"Workspace Setup","count":6},{"language":"ar","tag":"إعداد مساحة العمل","count":6},{"language":"cs","tag":"Začínáme","count":6},{"language":"cs","tag":"Nastavení pracovního prostoru","count":6},{"language":"da","tag":"Kom i gang","count":6},{"language":"da","tag":"Workspace-opsætning","count":6},{"language":"de","tag":"Erste Schritte","count":6},{"language":"de","tag":"Workspace einrichten","count":6},{"language":"es","tag":"Primeros pasos","count":6},{"language":"es","tag":"Configuración del espacio de trabajo","count":6},{"language":"fi","tag":"Työtilan asetukset","count":6},{"language":"fr","tag":"Prise en main","count":6},{"language":"fr","tag":"Configuration de l'espace de travail","count":6},{"language":"id","tag":"Pengaturan Ruang Kerja","count":6},{"language":"it","tag":"Configurazione Workspace","count":6},{"language":"ja","tag":"ワークスペース設定","count":6},{"language":"ko","tag":"시작하기","count":6},{"language":"ko","tag":"워크스페이스 설정","count":6},{"language":"lv","tag":"Darbvietas iestatīšana","count":6},{"language":"nl","tag":"Aan de slag","count":6},{"language":"nl","tag":"Werkruimte instellen","count":6},{"language":"no","tag":"Kom i gang","count":6},{"language":"no","tag":"Arbeidsområdeoppsett","count":6},{"language":"pl","tag":"Pierwsze Kroki","count":6},{"language":"pl","tag":"Konfiguracja Przestrzeni Roboczej","count":6},{"language":"pt-BR","tag":"Configuração do Espaço de Trabalho","count":6},{"language":"pt","tag":"Configuração do Espaço de Trabalho","count":6},{"language":"ro","tag":"Configurare Spațiu de Lucru","count":6},{"language":"ru","tag":"Начало работы","count":6},{"language":"ru","tag":"Настройка рабочего пространства","count":6},{"language":"sv","tag":"Kom igång","count":6},{"language":"sv","tag":"Arbetsyteinställning","count":6},{"language":"tr","tag":"Başlarken","count":6},{"language":"tr","tag":"Çalışma Alanı Kurulumu","count":6},{"language":"uz","tag":"Ish muhitini sozlash","count":6},{"language":"zh-Hant","tag":"工作區設定","count":6},{"language":"zh","tag":"工作区设置","count":6},{"language":"en","tag":"Team \u0026 Tasks","count":5},{"language":"en","tag":"Payments","count":5},{"language":"en","tag":"Services \u0026 Orders","count":5},{"language":"ar","tag":"الفريق والمهام","count":5},{"language":"ar","tag":"الخدمات والطلبات","count":5},{"language":"cs","tag":"Tým a úkoly","count":5},{"language":"cs","tag":"Platby","count":5},{"language":"cs","tag":"Služby a objednávky","count":5},{"language":"da","tag":"Team \u0026 Opgaver","count":5},{"language":"da","tag":"Betalinger","count":5},{"language":"da","tag":"Tjenester \u0026 Ordrer","count":5},{"language":"de","tag":"Team \u0026 Aufgaben","count":5},{"language":"de","tag":"Zahlungen","count":5},{"language":"de","tag":"Leistungen \u0026 Aufträge","count":5},{"language":"es","tag":"Equipo y tareas","count":5},{"language":"es","tag":"Pagos","count":5},{"language":"es","tag":"Servicios y pedidos","count":5},{"language":"fi","tag":"Tiimi ja tehtävät","count":5},{"language":"fi","tag":"Maksut","count":5},{"language":"fi","tag":"Palvelut ja tilaukset","count":5},{"language":"fr","tag":"Équipe et tâches","count":5},{"language":"fr","tag":"Paiements","count":5},{"language":"fr","tag":"Services et commandes","count":5},{"language":"id","tag":"Tim \u0026 Tugas","count":5},{"language":"id","tag":"Pembayaran","count":5},{"language":"id","tag":"Layanan \u0026 Pesanan","count":5},{"language":"it","tag":"Team e Attività","count":5},{"language":"it","tag":"Pagamenti","count":5},{"language":"it","tag":"Servizi e Ordini","count":5},{"language":"ja","tag":"はじめに","count":5},{"language":"ja","tag":"チームとタスク","count":5},{"language":"ja","tag":"サービスと注文","count":5},{"language":"ko","tag":"팀 \u0026 작업","count":5},{"language":"ko","tag":"서비스 \u0026 주문","count":5},{"language":"lv","tag":"Komanda un uzdevumi","count":5},{"language":"lv","tag":"Pakalpojumi un pasūtījumi","count":5},{"language":"nl","tag":"Team \u0026 Taken","count":5},{"language":"nl","tag":"Betalingen","count":5},{"language":"nl","tag":"Diensten \u0026 Bestellingen","count":5},{"language":"no","tag":"Team og oppgaver","count":5},{"language":"no","tag":"Betalinger","count":5},{"language":"no","tag":"Tjenester og ordre","count":5},{"language":"pl","tag":"Zespół i Zadania","count":5},{"language":"pl","tag":"Usługi i Zamówienia","count":5},{"language":"pt-BR","tag":"Equipe \u0026 Tarefas","count":5},{"language":"pt-BR","tag":"Pagamentos","count":5},{"language":"pt-BR","tag":"Serviços \u0026 Pedidos","count":5},{"language":"pt","tag":"Equipa \u0026 Tarefas","count":5},{"language":"pt","tag":"Pagamentos","count":5},{"language":"pt","tag":"Serviços \u0026 Encomendas","count":5},{"language":"ro","tag":"Echipă \u0026 Sarcini","count":5},{"language":"ro","tag":"Servicii \u0026 Comenzi","count":5},{"language":"ru","tag":"Команда и задачи","count":5},{"language":"ru","tag":"Услуги и заказы","count":5},{"language":"sv","tag":"Team \u0026 Uppgifter","count":5},{"language":"sv","tag":"Betalningar","count":5},{"language":"sv","tag":"Tjänster \u0026 Beställningar","count":5},{"language":"tr","tag":"Ekip \u0026 Görevler","count":5},{"language":"tr","tag":"Hizmetler \u0026 Siparişler","count":5},{"language":"uz","tag":"Jamoa va Vazifalar","count":5},{"language":"uz","tag":"Xizmatlar va Buyurtmalar","count":5},{"language":"zh-Hant","tag":"團隊與任務","count":5},{"language":"zh-Hant","tag":"服務與訂單","count":5},{"language":"zh","tag":"团队与任务","count":5},{"language":"zh","tag":"服务与订单","count":5},{"language":"en","tag":"API Reference","count":4},{"language":"en","tag":"CRM","count":4},{"language":"en","tag":"Get Started","count":4},{"language":"en","tag":"Proposals \u0026 Invoices","count":4},{"language":"ar","tag":"مرجع API","count":4},{"language":"ar","tag":"CRM","count":4},{"language":"ar","tag":"ابدأ الآن","count":4},{"language":"ar","tag":"المدفوعات","count":4},{"language":"ar","tag":"العروض والفواتير","count":4},{"language":"cs","tag":"API Reference","count":4},{"language":"cs","tag":"CRM","count":4},{"language":"cs","tag":"Nabídky a faktury","count":4},{"language":"da","tag":"API Reference","count":4},{"language":"da","tag":"CRM","count":4},{"language":"da","tag":"Tilbud \u0026 Fakturaer","count":4},{"language":"de","tag":"API Referenz","count":4},{"language":"de","tag":"CRM","count":4},{"language":"de","tag":"Angebote \u0026 Rechnungen","count":4},{"language":"es","tag":"Referencia de la API","count":4},{"language":"es","tag":"CRM","count":4},{"language":"es","tag":"Propuestas y facturas","count":4},{"language":"fi","tag":"API-viite","count":4},{"language":"fi","tag":"CRM","count":4},{"language":"fi","tag":"Aloita","count":4},{"language":"fi","tag":"Tarjoukset ja laskut","count":4},{"language":"fr","tag":"Référence API","count":4},{"language":"fr","tag":"CRM","count":4},{"language":"fr","tag":"Propositions et factures","count":4},{"language":"id","tag":"Referensi API","count":4},{"language":"id","tag":"CRM","count":4},{"language":"id","tag":"Mulai","count":4},{"language":"id","tag":"Proposal \u0026 Faktur","count":4},{"language":"it","tag":"Riferimento API","count":4},{"language":"it","tag":"CRM","count":4},{"language":"it","tag":"Inizia","count":4},{"language":"it","tag":"Proposte e Fatture","count":4},{"language":"ja","tag":"APIリファレンス","count":4},{"language":"ja","tag":"CRM","count":4},{"language":"ja","tag":"支払い","count":4},{"language":"ja","tag":"提案と請求書","count":4},{"language":"ko","tag":"API 레퍼런스","count":4},{"language":"ko","tag":"CRM","count":4},{"language":"ko","tag":"결제","count":4},{"language":"ko","tag":"제안서 \u0026 인보이스","count":4},{"language":"lv","tag":"API Uzziņa","count":4},{"language":"lv","tag":"CRM","count":4},{"language":"lv","tag":"Sākt","count":4},{"language":"lv","tag":"Maksājumi","count":4},{"language":"lv","tag":"Piedāvājumi un rēķini","count":4},{"language":"nl","tag":"API Referentie","count":4},{"language":"nl","tag":"CRM","count":4},{"language":"nl","tag":"Offertes \u0026 Facturen","count":4},{"language":"no","tag":"API-referanse","count":4},{"language":"no","tag":"CRM","count":4},{"language":"no","tag":"Tilbud og fakturaer","count":4},{"language":"pl","tag":"Dokumentacja API","count":4},{"language":"pl","tag":"CRM","count":4},{"language":"pl","tag":"Płatności","count":4},{"language":"pl","tag":"Oferty i Faktury","count":4},{"language":"pt-BR","tag":"Referência da API","count":4},{"language":"pt-BR","tag":"CRM","count":4},{"language":"pt-BR","tag":"Primeiros Passos","count":4},{"language":"pt-BR","tag":"Propostas \u0026 Faturas","count":4},{"language":"pt","tag":"Referência API","count":4},{"language":"pt","tag":"CRM","count":4},{"language":"pt","tag":"Começar","count":4},{"language":"pt","tag":"Propostas \u0026 Faturas","count":4},{"language":"ro","tag":"Referință API","count":4},{"language":"ro","tag":"CRM","count":4},{"language":"ro","tag":"Începe","count":4},{"language":"ro","tag":"Plăți","count":4},{"language":"ro","tag":"Propuneri \u0026 Facturi","count":4},{"language":"ru","tag":"Справочник API","count":4},{"language":"ru","tag":"CRM","count":4},{"language":"ru","tag":"Платежи","count":4},{"language":"ru","tag":"Предложения и счета","count":4},{"language":"sv","tag":"API-referens","count":4},{"language":"sv","tag":"CRM","count":4},{"language":"sv","tag":"Offerter \u0026 Fakturor","count":4},{"language":"tr","tag":"API Referansı","count":4},{"language":"tr","tag":"CRM","count":4},{"language":"tr","tag":"Ödemeler","count":4},{"language":"tr","tag":"Teklifler \u0026 Faturalar","count":4},{"language":"uz","tag":"API Ma'lumotnomasi","count":4},{"language":"uz","tag":"CRM","count":4},{"language":"uz","tag":"Boshlash","count":4},{"language":"uz","tag":"To'lovlar","count":4},{"language":"uz","tag":"Takliflar va Hisob-fakturalar","count":4},{"language":"zh-Hant","tag":"API 參考","count":4},{"language":"zh-Hant","tag":"CRM","count":4},{"language":"zh-Hant","tag":"開始使用","count":4},{"language":"zh-Hant","tag":"付款","count":4},{"language":"zh-Hant","tag":"提案與發票","count":4},{"language":"zh","tag":"API 参考","count":4},{"language":"zh","tag":"CRM","count":4},{"language":"zh","tag":"快速入门","count":4},{"language":"zh","tag":"付款","count":4},{"language":"zh","tag":"提案与发票","count":4}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":":root{--default-border-color: var(--gray-200)}.dark{--default-border-color: var(--gray-800)}#sidebar .nav-dropdown-trigger{border:none!important;background:transparent!important;box-shadow:none!important;padding-left:0.375rem}#sidebar .nav-dropdown-trigger:hover{background-color:rgb(0 0 0 / 0.04)!important}.dark #sidebar .nav-dropdown-trigger:hover{background-color:rgb(255 255 255 / 0.06)!important}#sidebar .nav-dropdown-trigger .nav-dropdown-item-icon{border:none!important;background:transparent!important;height:auto!important;width:auto!important;padding:0!important}.nav-dropdown-content{}.nav-dropdown-content .nav-dropdown-item{}.nav-dropdown-content .nav-dropdown-item-icon{border:none!important;background:transparent!important;height:auto!important;width:auto!important;padding:0!important}.nav-dropdown-content .nav-dropdown-item-description{display:none!important}#sidebar .nav-anchor span{font-family:ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, monospace;font-size:12px;font-weight:500;letter-spacing:-0.02em;text-transform:uppercase}body:has([data-product-guide-index]) #sidebar a.nav-anchor[href=\"/\"]{color:rgb(var(--primary))!important;font-weight:600!important}body:has([data-product-guide-index]) #sidebar a.nav-anchor[href=\"/\"] span{color:inherit!important}body:has([data-product-guide-index]) #sidebar a.nav-anchor[href=\"/\"] svg{background-color:rgb(var(--primary))!important}.dark body:has([data-product-guide-index]) #sidebar a.nav-anchor[href=\"/\"]{color:rgb(var(--primary-light)/var(--tw-text-opacity,1))!important}.dark body:has([data-product-guide-index]) #sidebar a.nav-anchor[href=\"/\"] svg{background-color:rgb(var(--primary-light)/var(--tw-text-opacity,1))!important}:is(#content-area[data-current-path=\"/\"],[data-current-path=\"/\"] #content-area):has([data-product-guide-index]){background:transparent!important;padding:0!important}:is(#content-area[data-current-path=\"/\"],[data-current-path=\"/\"] #content-area):has([data-product-guide-index])>div:first-child{background:transparent!important;padding-right:0!important;padding-bottom:0!important;padding-left:0!important}[data-product-guide-index] a:not(.product-guide-feature-card){background-color:#fafafa!important}.dark [data-product-guide-index] a:not(.product-guide-feature-card){background-color:#09090b!important}.product-guide-feature-card{grid-column:1 / -1;display:flex!important;flex-direction:column!important;justify-content:space-between!important;min-height:260px;background:url('/images/sample-feature-light.png') center / cover no-repeat!important;border:none!important;box-shadow:none!important;color:white!important;.dark \u0026 {\n background-image: url('/images/sample-feature-dark.png') !important;\n }}.product-guide-feature-card>div{display:flex!important;flex:1;flex-direction:column!important;justify-content:space-between!important}.product-guide-feature-card :is(h2,h3,p,span,svg){color:white!important}.product-guide-feature-card :is(svg,[class*=\"icon\"]){background-color:white!important;width:2em!important;height:2em!important;margin-top:2px}.product-guide-feature-card-title{font-size:1.2em;font-weight:500}.product-guide-feature-card :is(h2,h3,p,span,svg).product-guide-feature-card-description{font-size:1.05em;font-weight:400;color:rgb(var(--gray-50) / 62.5%)!important;.dark \u0026 {\n color: rgb(var(--gray-50) / 50%) !important;\n }}img.nav-logo{max-width:220px;height:auto}"}],"page":{"pagePath":"zh-Hant/api/create-client","slug":"/zh-Hant/api/create-client","pageMetadata":{"title":"AgencyHandy API:以程式方式建立新客戶","sidebarTitle":"建立客戶","description":"透過向 bulk-client 端點傳送包含姓名、電子郵件及聯絡資訊的請求,以程式方式將新客戶新增至您的 AgencyHandy 工作區。","href":"/zh-Hant/api/create-client"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"透過向 bulk-client 端點傳送包含姓名、電子郵件及聯絡資訊的請求,以程式方式將新客戶新增至您的 AgencyHandy 工作區。\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,hr:`hr`,li:`li`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Heading,Note,ParamField,ResponseField,Table,Tip,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!ResponseField)_missingMdxReference(`ResponseField`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Tip)_missingMdxReference(`Tip`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`The Create Client endpoint lets you add clients directly to your AgencyHandy workspace from an external system. Unlike leads, clients are fully onboarded contacts who can be assigned to orders, invoices, and projects. Use this endpoint to sync new clients from a CRM, onboarding form, or any other data source.`}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`Before using this endpoint, complete the `,_jsx(_components.a,{href:`/zh-Hant/api/getting-started`,children:`Getting Started`}),` guide to obtain your API key. You do not need to send a company ID or role ID. AgencyHandy assigns the client to the workspace client role automatically.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`prerequisites`,children:`Prerequisites`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`✅ API key generated from `,_jsx(_components.strong,{children:`Workspace Config → API Key`})]}),`\n`]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`endpoint`,children:`Endpoint`}),`\n`,_jsx(CodeBlock,{numberOfLines:`2`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`POST {{URL}}/members/bulk-client`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsx(Heading,{level:`2`,id:`headers`,children:`Headers`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Header`}),_jsx(_components.th,{children:`Value`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`x-api-key`})}),_jsx(_components.td,{children:`Your API key`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`Content-Type`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`application/json`})})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`request-body`,children:`Request body`}),`\n`,_jsxs(_components.p,{children:[`The request body is a `,_jsx(_components.strong,{children:`JSON array`}),`. You can create one or more clients in a single request.`]}),`\n`,_jsx(ParamField,{body:`email`,type:`string`,required:true,id:`param-email`,children:_jsx(_components.p,{children:`The client’s email address. It must be valid and should be unique within your workspace.`})}),`\n`,_jsx(ParamField,{body:`firstName`,type:`string`,required:true,id:`param-first-name`,children:_jsx(_components.p,{children:`The client’s first name.`})}),`\n`,_jsx(ParamField,{body:`lastName`,type:`string`,required:true,id:`param-last-name`,children:_jsx(_components.p,{children:`The client’s last name.`})}),`\n`,_jsx(ParamField,{body:`status`,type:`string`,required:true,id:`param-status`,children:_jsxs(_components.p,{children:[`The client’s status. The only accepted value for this endpoint is `,_jsx(_components.code,{children:`Client`}),`.`]})}),`\n`,_jsx(ParamField,{body:`password`,type:`string`,id:`param-password`,children:_jsx(_components.p,{children:`Optional password for the client. If provided, it must contain at least 8 characters, one uppercase letter, one lowercase letter, one number, and one special character.`})}),`\n`,_jsx(ParamField,{body:`contactNo`,type:`string`,id:`param-contact-no`,children:_jsx(_components.p,{children:`The client’s phone number. Optional. Defaults to an empty string if omitted.`})}),`\n`,_jsx(ParamField,{body:`country`,type:`string`,id:`param-country`,children:_jsx(_components.p,{children:`The client’s country. Optional.`})}),`\n`,_jsx(ParamField,{body:`city`,type:`string`,id:`param-city`,children:_jsx(_components.p,{children:`The client’s city. Optional.`})}),`\n`,_jsx(ParamField,{body:`state`,type:`string`,id:`param-state`,children:_jsx(_components.p,{children:`The client’s state or region. Optional.`})}),`\n`,_jsx(ParamField,{body:`zipCode`,type:`string`,id:`param-zip-code`,children:_jsx(_components.p,{children:`The client’s ZIP or postal code. Optional.`})}),`\n`,_jsx(ParamField,{body:`address`,type:`string`,id:`param-address`,children:_jsx(_components.p,{children:`The client’s address. Optional.`})}),`\n`,_jsx(ParamField,{body:`category`,type:`string[]`,id:`param-category`,children:_jsx(_components.p,{children:`Optional array of category or label IDs. Each ID must exist in the workspace.`})}),`\n`,_jsx(ParamField,{body:`companyName`,type:`string`,id:`param-company-name`,children:_jsx(_components.p,{children:`The client’s company name. Optional.`})}),`\n`,_jsx(ParamField,{body:`sendInvitationEmail`,type:`boolean`,id:`param-send-invitation-email`,children:_jsxs(_components.p,{children:[`Whether to send an invitation email. Optional. Defaults to `,_jsx(_components.code,{children:`true`}),`.`]})}),`\n`,_jsx(ParamField,{body:`source`,type:`string`,id:`param-source`,children:_jsxs(_components.p,{children:[`How you acquired this client. Optional. Example values: `,_jsx(_components.code,{children:`website`}),`, `,_jsx(_components.code,{children:`referral`}),`, `,_jsx(_components.code,{children:`social`}),`.`]})}),`\n`,_jsx(ParamField,{body:`leadValue`,type:`string`,id:`param-lead-value`,children:_jsx(_components.p,{children:`The estimated value associated with the client. Optional.`})}),`\n`,_jsx(ParamField,{body:`website`,type:`string`,id:`param-website`,children:_jsx(_components.p,{children:`The client’s website. Optional.`})}),`\n`,_jsx(ParamField,{body:`agent`,type:`string`,id:`param-agent`,children:_jsx(_components.p,{children:`Optional assigned agent ID.`})}),`\n`,_jsx(ParamField,{body:`lastContactedAt`,type:`string`,id:`param-last-contacted-at`,children:_jsx(_components.p,{children:`Optional date for when the client was last contacted.`})}),`\n`,_jsx(ParamField,{body:`files`,type:`string[]`,id:`param-files`,children:_jsx(_components.p,{children:`Optional array of file IDs attached to the client.`})}),`\n`,_jsx(ParamField,{body:`profileImage`,type:`string`,id:`param-profile-image`,children:_jsx(_components.p,{children:`Optional profile image URL or file reference.`})}),`\n`,_jsx(ParamField,{body:`customFields`,type:`array`,id:`param-custom-fields`,children:_jsx(_components.p,{children:`Optional custom field responses for client custom fields.`})}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`Do not send `,_jsx(_components.code,{children:`companyId`}),`, `,_jsx(_components.code,{children:`role`}),`, `,_jsx(_components.code,{children:`isConvertedClient`}),`, or `,_jsx(_components.code,{children:`positionInBoard`}),`. The endpoint does not use those request fields. Unknown fields are removed during validation.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`full-payload-example`,children:`Full payload example`}),`\n`,_jsxs(_components.p,{children:[`Only `,_jsx(_components.code,{children:`email`}),`, `,_jsx(_components.code,{children:`firstName`}),`, `,_jsx(_components.code,{children:`lastName`}),`, and `,_jsx(_components.code,{children:`status`}),` are required. Every other field shown here is optional.`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`51`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`51`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`[`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"email\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"john.doe@example.com\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Client\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"password\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"StrongPass1!\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"firstName\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"John\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"lastName\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Doe\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"contactNo\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"1234567890\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"country\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"United States\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"city\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"New York\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"state\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"NY\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"zipCode\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"10001\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"address\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"123 Main Street\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"category\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"6525994184e9ddd798534535\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`],`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"companyName\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Example Inc.\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"sendInvitationEmail\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"source\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"website\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"leadValue\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2500\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"website\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://example.com\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"agent\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"6525994184e9ddd798534536\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"lastContactedAt\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-07-19T10:00:00.000Z\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"files\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"6525994184e9ddd798534537\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`],`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"profileImage\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://example.com/avatar.png\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"customFields\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"6525994184e9ddd798534538\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"stringValue\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Interested in monthly services\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"numberValue\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`2500`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"dateValue\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-07-19T00:00:00.000Z\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"booleanValue\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"arrayValue\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"value\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"paid-search\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"label\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Paid Search\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ],`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"fileValue\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"6525994184e9ddd798534539\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"link\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://example.com/file.pdf\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"sizeInBytes\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"102400\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"s3Key\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"uploads/file.pdf\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"type\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"application/pdf\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"company\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"6525994184e9ddd798534540\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"isVersion\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`false`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ]`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ]`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`]`})}),`\n`]})})}),`\n`,_jsx(ParamField,{body:`customFields[]._id`,type:`string`,required:true,id:`param-custom-fields-id`,children:_jsx(_components.p,{children:`The custom field ID when sending a custom field response.`})}),`\n`,_jsx(ParamField,{body:`customFields[].stringValue`,type:`string`,id:`param-custom-fields-string-value`,children:_jsx(_components.p,{children:`Optional string response value.`})}),`\n`,_jsx(ParamField,{body:`customFields[].numberValue`,type:`number`,id:`param-custom-fields-number-value`,children:_jsx(_components.p,{children:`Optional number response value.`})}),`\n`,_jsx(ParamField,{body:`customFields[].dateValue`,type:`string`,id:`param-custom-fields-date-value`,children:_jsx(_components.p,{children:`Optional date response value.`})}),`\n`,_jsx(ParamField,{body:`customFields[].booleanValue`,type:`boolean`,id:`param-custom-fields-boolean-value`,children:_jsx(_components.p,{children:`Optional boolean response value.`})}),`\n`,_jsx(ParamField,{body:`customFields[].arrayValue`,type:`array`,id:`param-custom-fields-array-value`,children:_jsxs(_components.p,{children:[`Optional array response value. Each item can include `,_jsx(_components.code,{children:`value`}),` and `,_jsx(_components.code,{children:`label`}),`.`]})}),`\n`,_jsx(ParamField,{body:`customFields[].fileValue`,type:`array`,id:`param-custom-fields-file-value`,children:_jsxs(_components.p,{children:[`Optional file response value. Each file item must include `,_jsx(_components.code,{children:`_id`}),`, `,_jsx(_components.code,{children:`link`}),`, `,_jsx(_components.code,{children:`sizeInBytes`}),`, `,_jsx(_components.code,{children:`s3Key`}),`, `,_jsx(_components.code,{children:`type`}),`, `,_jsx(_components.code,{children:`company`}),`, and `,_jsx(_components.code,{children:`isVersion`}),`.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`example-request`,children:`Example request`}),`\n`,_jsx(CodeBlock,{filename:`cURL`,numberOfLines:`14`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`14`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --request`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"https://api.agencyhandy.com/members/bulk-client\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --header`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"x-api-key: \u003cYOUR_API_KEY>\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --header`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Content-Type: application/json\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --data`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '[`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` {`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"email\": \"john.doe@example.com\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"status\": \"Client\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"firstName\": \"John\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"lastName\": \"Doe\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"contactNo\": \"1234567890\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"source\": \"website\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"sendInvitationEmail\": true`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` ]'`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`success-response`,children:`Success response`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`20`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`20`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"success\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"data\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"addedClients\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"NEW_MEMBER_ID\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"email\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"john.doe@example.com\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"firstName\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"John\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"lastName\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Doe\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"John Doe\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Client\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"source\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"website\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"isConvertedClient\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"isAccountVerified\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"isApproved\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ],`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"notAddedClients\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: []`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(ResponseField,{name:`success`,type:`boolean`,id:`param-success`,children:_jsx(_components.p,{children:`Indicates whether at least one client was added.`})}),`\n`,_jsx(ResponseField,{name:`data.addedClients`,type:`array`,id:`param-data-added-clients`,children:_jsx(_components.p,{children:`Clients that were created, restored, or converted from existing leads.`})}),`\n`,_jsx(ResponseField,{name:`data.addedClients[].\\\\_id`,type:`string`,id:`param-data-added-clients-id`,children:_jsx(_components.p,{children:`Unique ID of the newly created client. Use this ID when assigning the client to orders or invoices via the API.`})}),`\n`,_jsx(ResponseField,{name:`data.addedClients[].name`,type:`string`,id:`param-data-added-clients-name`,children:_jsx(_components.p,{children:`The full name of the client (firstName + lastName).`})}),`\n`,_jsx(ResponseField,{name:`data.addedClients[].status`,type:`string`,id:`param-data-added-clients-status`,children:_jsx(_components.p,{children:`The status of the client as stored.`})}),`\n`,_jsx(ResponseField,{name:`data.notAddedClients`,type:`array`,id:`param-data-not-added-clients`,children:_jsxs(_components.p,{children:[`Clients that were not created. Each item includes the submitted `,_jsx(_components.code,{children:`email`}),` and a `,_jsx(_components.code,{children:`reason`}),`, such as `,_jsx(_components.code,{children:`Client already exists`}),` or `,_jsx(_components.code,{children:`One or more category not found`}),`.`]})}),`\n`,_jsx(Tip,{children:_jsx(_components.p,{children:`You can pass up to 200 client objects in the array. If a submitted email belongs to an existing lead, AgencyHandy converts that lead into a client.`})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"AgencyHandy API:以程式方式建立新客戶","sidebarTitle":"建立客戶","description":"透過向 bulk-client 端點傳送包含姓名、電子郵件及聯絡資訊的請求,以程式方式將新客戶新增至您的 AgencyHandy 工作區。","href":"/zh-Hant/api/create-client"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Prerequisites","slug":"prerequisites","depth":2,"children":[]},{"title":"Endpoint","slug":"endpoint","depth":2,"children":[]},{"title":"Headers","slug":"headers","depth":2,"children":[]},{"title":"Request body","slug":"request-body","depth":2,"children":[]},{"title":"Full payload example","slug":"full-payload-example","depth":2,"children":[]},{"title":"Example request","slug":"example-request","depth":2,"children":[]},{"title":"Success response","slug":"success-response","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"agencyhandy-36ccbd64","siteName":"AgencyHandy","title":"AgencyHandy API:以程式方式建立新客戶 - AgencyHandy","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"en":{"href":"/api/create-client","matchLevel":1},"fr":{"href":"/fr/api/create-client","matchLevel":1},"es":{"href":"/es/api/create-client","matchLevel":1},"zh":{"href":"/zh/api/create-client","matchLevel":1},"zh-Hant":{"href":"/zh-Hant/api/create-client","matchLevel":0},"de":{"href":"/de/api/create-client","matchLevel":1},"ko":{"href":"/ko/api/create-client","matchLevel":1},"cs":{"href":"/cs/api/create-client","matchLevel":1},"ja":{"href":"/ja/api/create-client","matchLevel":1},"it":{"href":"/it/api/create-client","matchLevel":1},"lv":{"href":"/lv/api/create-client","matchLevel":1},"no":{"href":"/no/api/create-client","matchLevel":1},"ar":{"href":"/ar/api/create-client","matchLevel":1},"sv":{"href":"/sv/api/create-client","matchLevel":1},"da":{"href":"/da/api/create-client","matchLevel":1},"pl":{"href":"/pl/api/create-client","matchLevel":1},"nl":{"href":"/nl/api/create-client","matchLevel":1},"tr":{"href":"/tr/api/create-client","matchLevel":1},"uz":{"href":"/uz/api/create-client","matchLevel":1},"ru":{"href":"/ru/api/create-client","matchLevel":1},"pt":{"href":"/pt/api/create-client","matchLevel":1},"pt-BR":{"href":"/pt-BR/api/create-client","matchLevel":1},"id":{"href":"/id/api/create-client","matchLevel":1},"fi":{"href":"/fi/api/create-client","matchLevel":1},"ro":{"href":"/ro/api/create-client","matchLevel":1}}},"lastModified":"2026-07-19T10:50:10.522Z","originalFileLocation":"zh-Hant/api/create-client.mdx","locale":"zh-Hant"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"透過向 bulk-client 端點傳送包含姓名、電子郵件及聯絡資訊的請求,以程式方式將新客戶新增至您的 AgencyHandy 工作區。\">\u003cmeta data-mint-head name=\"application-name\" content=\"AgencyHandy\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/agencyhandy-36ccbd64/wHCw4lr1rsoG49s8/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/agencyhandy-36ccbd64/wHCw4lr1rsoG49s8/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/agencyhandy-36ccbd64/wHCw4lr1rsoG49s8/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/agencyhandy-36ccbd64/wHCw4lr1rsoG49s8/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/agencyhandy-36ccbd64/wHCw4lr1rsoG49s8/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/agencyhandy-36ccbd64/wHCw4lr1rsoG49s8/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/agencyhandy-36ccbd64/wHCw4lr1rsoG49s8/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/agencyhandy-36ccbd64/wHCw4lr1rsoG49s8/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/agencyhandy-36ccbd64/wHCw4lr1rsoG49s8/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"AgencyHandy API:以程式方式建立新客戶 - AgencyHandy\">\u003cmeta data-mint-head property=\"og:description\" content=\"透過向 bulk-client 端點傳送包含姓名、電子郵件及聯絡資訊的請求,以程式方式將新客戶新增至您的 AgencyHandy 工作區。\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"AgencyHandy\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.agencyhandy.com/zh-Hant/api/create-client\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://agencyhandy-36ccbd64.mintlify.site/_mintlify/api/og/v2?division=%E7%AB%AF%E9%BB%9E\u0026amp;title=AgencyHandy+API%EF%BC%9A%E4%BB%A5%E7%A8%8B%E5%BC%8F%E6%96%B9%E5%BC%8F%E5%BB%BA%E7%AB%8B%E6%96%B0%E5%AE%A2%E6%88%B6\u0026amp;description=%E9%80%8F%E9%81%8E%E5%90%91+bulk-client+%E7%AB%AF%E9%BB%9E%E5%82%B3%E9%80%81%E5%8C%85%E5%90%AB%E5%A7%93%E5%90%8D%E3%80%81%E9%9B%BB%E5%AD%90%E9%83%B5%E4%BB%B6%E5%8F%8A%E8%81%AF%E7%B5%A1%E8%B3%87%E8%A8%8A%E7%9A%84%E8%AB%8B%E6%B1%82%EF%BC%8C%E4%BB%A5%E7%A8%8B%E5%BC%8F%E6%96%B9%E5%BC%8F%E5%B0%87%E6%96%B0%E5%AE%A2%E6%88%B6%E6%96%B0%E5%A2%9E%E8%87%B3%E6%82%A8%E7%9A%84+AgencyHandy+%E5%B7%A5%E4%BD%9C%E5%8D%80%E3%80%82\u0026amp;theme=f12257f07512dce625f56f39\u0026amp;signature=97fd88a8dc6bb9edf00c58fafaac4adfcb32809c05fdd32526486ab8ebb4f330\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"AgencyHandy API:以程式方式建立新客戶 - AgencyHandy\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"透過向 bulk-client 端點傳送包含姓名、電子郵件及聯絡資訊的請求,以程式方式將新客戶新增至您的 AgencyHandy 工作區。\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://agencyhandy-36ccbd64.mintlify.site/_mintlify/api/og/v2?division=%E7%AB%AF%E9%BB%9E\u0026amp;title=AgencyHandy+API%EF%BC%9A%E4%BB%A5%E7%A8%8B%E5%BC%8F%E6%96%B9%E5%BC%8F%E5%BB%BA%E7%AB%8B%E6%96%B0%E5%AE%A2%E6%88%B6\u0026amp;description=%E9%80%8F%E9%81%8E%E5%90%91+bulk-client+%E7%AB%AF%E9%BB%9E%E5%82%B3%E9%80%81%E5%8C%85%E5%90%AB%E5%A7%93%E5%90%8D%E3%80%81%E9%9B%BB%E5%AD%90%E9%83%B5%E4%BB%B6%E5%8F%8A%E8%81%AF%E7%B5%A1%E8%B3%87%E8%A8%8A%E7%9A%84%E8%AB%8B%E6%B1%82%EF%BC%8C%E4%BB%A5%E7%A8%8B%E5%BC%8F%E6%96%B9%E5%BC%8F%E5%B0%87%E6%96%B0%E5%AE%A2%E6%88%B6%E6%96%B0%E5%A2%9E%E8%87%B3%E6%82%A8%E7%9A%84+AgencyHandy+%E5%B7%A5%E4%BD%9C%E5%8D%80%E3%80%82\u0026amp;theme=f12257f07512dce625f56f39\u0026amp;signature=97fd88a8dc6bb9edf00c58fafaac4adfcb32809c05fdd32526486ab8ebb4f330\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/agencyhandy-36ccbd64/wHCw4lr1rsoG49s8/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"AgencyHandy\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#6C5CE7\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.agencyhandy.com/zh-Hant/api/create-client\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/zh-Hant/api/create-client.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"zh-Hant\" href=\"https://docs.agencyhandy.com/zh-Hant/api/create-client\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://docs.agencyhandy.com/api/create-client\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"fr\" href=\"https://docs.agencyhandy.com/fr/api/create-client\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"es\" href=\"https://docs.agencyhandy.com/es/api/create-client\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"zh\" href=\"https://docs.agencyhandy.com/zh/api/create-client\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"de\" href=\"https://docs.agencyhandy.com/de/api/create-client\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ko\" href=\"https://docs.agencyhandy.com/ko/api/create-client\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"cs\" href=\"https://docs.agencyhandy.com/cs/api/create-client\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ja\" href=\"https://docs.agencyhandy.com/ja/api/create-client\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"it\" href=\"https://docs.agencyhandy.com/it/api/create-client\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"lv\" href=\"https://docs.agencyhandy.com/lv/api/create-client\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"no\" href=\"https://docs.agencyhandy.com/no/api/create-client\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ar\" href=\"https://docs.agencyhandy.com/ar/api/create-client\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"sv\" href=\"https://docs.agencyhandy.com/sv/api/create-client\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"da\" href=\"https://docs.agencyhandy.com/da/api/create-client\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"pl\" href=\"https://docs.agencyhandy.com/pl/api/create-client\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"nl\" href=\"https://docs.agencyhandy.com/nl/api/create-client\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"tr\" href=\"https://docs.agencyhandy.com/tr/api/create-client\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"uz\" href=\"https://docs.agencyhandy.com/uz/api/create-client\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ru\" href=\"https://docs.agencyhandy.com/ru/api/create-client\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"pt\" href=\"https://docs.agencyhandy.com/pt/api/create-client\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"pt-BR\" href=\"https://docs.agencyhandy.com/pt-BR/api/create-client\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"id\" href=\"https://docs.agencyhandy.com/id/api/create-client\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"fi\" href=\"https://docs.agencyhandy.com/fi/api/create-client\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ro\" href=\"https://docs.agencyhandy.com/ro/api/create-client\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://docs.agencyhandy.com/api/create-client\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.agencyhandy.com/#organization\",\"name\":\"AgencyHandy\",\"url\":\"https://docs.agencyhandy.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/agencyhandy-36ccbd64/zJLfimHmfDAoxavv/logo/agencyhandy-light.png?fit=max\u0026auto=format\u0026n=zJLfimHmfDAoxavv\u0026q=85\u0026s=4f7abbc6052d4ca949dd929c3b6e3c00\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.agencyhandy.com#website\",\"name\":\"AgencyHandy\",\"url\":\"https://docs.agencyhandy.com\",\"publisher\":{\"@id\":\"https://docs.agencyhandy.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.agencyhandy.com/zh-Hant/api/create-client#webpage\",\"url\":\"https://docs.agencyhandy.com/zh-Hant/api/create-client\",\"name\":\"AgencyHandy API:以程式方式建立新客戶\",\"description\":\"透過向 bulk-client 端點傳送包含姓名、電子郵件及聯絡資訊的請求,以程式方式將新客戶新增至您的 AgencyHandy 工作區。\",\"dateModified\":\"2026-07-19T10:50:10.522Z\",\"isPartOf\":{\"@id\":\"https://docs.agencyhandy.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.agencyhandy.com/zh-Hant/api/create-client#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.agencyhandy.com/zh-Hant/api/create-client#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"端點\",\"item\":\"https://docs.agencyhandy.com/zh-Hant/api/create-lead\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"AgencyHandy API:以程式方式建立新客戶\",\"item\":\"https://docs.agencyhandy.com/zh-Hant/api/create-client\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.agencyhandy.com/zh-Hant/api/create-client#article\",\"headline\":\"AgencyHandy API:以程式方式建立新客戶\",\"name\":\"AgencyHandy API:以程式方式建立新客戶\",\"description\":\"透過向 bulk-client 端點傳送包含姓名、電子郵件及聯絡資訊的請求,以程式方式將新客戶新增至您的 AgencyHandy 工作區。\",\"url\":\"https://docs.agencyhandy.com/zh-Hant/api/create-client\",\"mainEntityOfPage\":{\"@id\":\"https://docs.agencyhandy.com/zh-Hant/api/create-client#webpage\"},\"dateModified\":\"2026-07-19T10:50:10.522Z\",\"publisher\":{\"@id\":\"https://docs.agencyhandy.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.agencyhandy.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"AgencyHandy\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"AgencyHandy\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/zh-Hant/api/create-client.md","siteName":"AgencyHandy","nav":{"global":null,"directory":"card","languages":[{"language":"en","default":true,"navbar":{"links":[],"primary":{"type":"button","label":"Sign In","href":"https://app.agencyhandy.com"}},"pages":[{"title":"en","href":"/api/create-client"}]},{"language":"fr","navbar":{"links":[],"primary":{"type":"button","label":"Se connecter","href":"https://app.agencyhandy.com"}},"pages":[{"title":"fr","href":"/fr/api/create-client"}]},{"language":"es","navbar":{"links":[],"primary":{"type":"button","label":"Iniciar sesión","href":"https://app.agencyhandy.com"}},"pages":[{"title":"es","href":"/es/api/create-client"}]},{"language":"zh","navbar":{"links":[],"primary":{"type":"button","label":"登录","href":"https://app.agencyhandy.com"}},"pages":[{"title":"zh","href":"/zh/api/create-client"}]},{"language":"zh-Hant","navbar":{"links":[],"primary":{"type":"button","label":"登入","href":"https://app.agencyhandy.com"}},"tabs":[{"tab":"適用於代理商","pages":[{"title":"適用於代理商","href":"/zh-Hant/getting-started/introduction"}]},{"tab":"適用於客戶","pages":[{"title":"適用於客戶","href":"/zh-Hant/client/introduction"}]},{"tab":"API 參考","groups":[{"group":"簡介","icon":"book-open","expanded":true,"pages":[{"title":"AgencyHandy API:驗證與入門指南","sidebarTitle":"入門指南","href":"/zh-Hant/api/getting-started"}]},{"group":"端點","icon":"code","pages":[{"title":"AgencyHandy API:以程式方式建立新的潛在客戶","sidebarTitle":"建立潛在客戶","description":"使用 AgencyHandy API,透過向 bulk-lead 端點傳送帶有必填欄位的 POST 請求,以程式方式建立新的潛在客戶。","href":"/zh-Hant/api/create-lead"},{"title":"AgencyHandy API:以程式方式建立新客戶","sidebarTitle":"建立客戶","href":"/zh-Hant/api/create-client"},{"title":"AgencyHandy API:使用 PUT 更新現有訂單","sidebarTitle":"更新訂單","description":"使用 AgencyHandy API 透過 PUT 請求更新訂單詳情、變更狀態、重新指派專案經理,以及為現有訂單附加檔案。","href":"/zh-Hant/api/update-order"}]}]}],"global":{"anchors":[{"anchor":"首頁","icon":"house","href":"/zh-Hant"},{"anchor":"AgencyHandy 應用程式","icon":"arrow-up-right","href":"https://app.agencyhandy.com"},{"anchor":"社群","icon":"users","href":"https://community.agencyhandy.com"},{"anchor":"部落格","icon":"newspaper","href":"https://www.agencyhandy.com/blog"}]}},{"language":"de","navbar":{"links":[],"primary":{"type":"button","label":"Anmelden","href":"https://app.agencyhandy.com"}},"pages":[{"title":"de","href":"/de/api/create-client"}]},{"language":"ko","navbar":{"links":[],"primary":{"type":"button","label":"로그인","href":"https://app.agencyhandy.com"}},"pages":[{"title":"ko","href":"/ko/api/create-client"}]},{"language":"cs","navbar":{"links":[],"primary":{"type":"button","label":"Přihlásit se","href":"https://app.agencyhandy.com"}},"pages":[{"title":"cs","href":"/cs/api/create-client"}]},{"language":"ja","navbar":{"links":[],"primary":{"type":"button","label":"サインイン","href":"https://app.agencyhandy.com"}},"pages":[{"title":"ja","href":"/ja/api/create-client"}]},{"language":"it","navbar":{"links":[],"primary":{"type":"button","label":"Accedi","href":"https://app.agencyhandy.com"}},"pages":[{"title":"it","href":"/it/api/create-client"}]},{"language":"lv","navbar":{"links":[],"primary":{"type":"button","label":"Pierakstīties","href":"https://app.agencyhandy.com"}},"pages":[{"title":"lv","href":"/lv/api/create-client"}]},{"language":"no","navbar":{"links":[],"primary":{"type":"button","label":"Logg inn","href":"https://app.agencyhandy.com"}},"pages":[{"title":"no","href":"/no/api/create-client"}]},{"language":"ar","navbar":{"links":[],"primary":{"type":"button","label":"تسجيل الدخول","href":"https://app.agencyhandy.com"}},"pages":[{"title":"ar","href":"/ar/api/create-client"}]},{"language":"sv","navbar":{"links":[],"primary":{"type":"button","label":"Logga in","href":"https://app.agencyhandy.com"}},"pages":[{"title":"sv","href":"/sv/api/create-client"}]},{"language":"da","navbar":{"links":[],"primary":{"type":"button","label":"Log ind","href":"https://app.agencyhandy.com"}},"pages":[{"title":"da","href":"/da/api/create-client"}]},{"language":"pl","navbar":{"links":[],"primary":{"type":"button","label":"Zaloguj się","href":"https://app.agencyhandy.com"}},"pages":[{"title":"pl","href":"/pl/api/create-client"}]},{"language":"nl","navbar":{"links":[],"primary":{"type":"button","label":"Inloggen","href":"https://app.agencyhandy.com"}},"pages":[{"title":"nl","href":"/nl/api/create-client"}]},{"language":"tr","navbar":{"links":[],"primary":{"type":"button","label":"Giriş Yap","href":"https://app.agencyhandy.com"}},"pages":[{"title":"tr","href":"/tr/api/create-client"}]},{"language":"uz","navbar":{"links":[],"primary":{"type":"button","label":"Kirish","href":"https://app.agencyhandy.com"}},"pages":[{"title":"uz","href":"/uz/api/create-client"}]},{"language":"ru","navbar":{"links":[],"primary":{"type":"button","label":"Войти","href":"https://app.agencyhandy.com"}},"pages":[{"title":"ru","href":"/ru/api/create-client"}]},{"language":"pt","navbar":{"links":[],"primary":{"type":"button","label":"Iniciar Sessão","href":"https://app.agencyhandy.com"}},"pages":[{"title":"pt","href":"/pt/api/create-client"}]},{"language":"pt-BR","navbar":{"links":[],"primary":{"type":"button","label":"Entrar","href":"https://app.agencyhandy.com"}},"pages":[{"title":"pt-BR","href":"/pt-BR/api/create-client"}]},{"language":"id","navbar":{"links":[],"primary":{"type":"button","label":"Masuk","href":"https://app.agencyhandy.com"}},"pages":[{"title":"id","href":"/id/api/create-client"}]},{"language":"fi","navbar":{"links":[],"primary":{"type":"button","label":"Kirjaudu sisään","href":"https://app.agencyhandy.com"}},"pages":[{"title":"fi","href":"/fi/api/create-client"}]},{"language":"ro","navbar":{"links":[],"primary":{"type":"button","label":"Conectare","href":"https://app.agencyhandy.com"}},"pages":[{"title":"ro","href":"/ro/api/create-client"}]}]},"basePath":"","title":"AgencyHandy API:以程式方式建立新客戶 - AgencyHandy","deploymentId":"dpl_FZMKUpaaKiVETbfqhoUe4sPFDTmY","buildId":"dpl_FZMKUpaaKiVETbfqhoUe4sPFDTmY","dynamics":[],"chunks":[]}