Cria um desafio de passageiro para uma lista fechada de clientes da central. Só os clientes da lista veem o desafio no app, contam corridas nele e recebem o push diário; a lista é gravada na criação e não muda depois, nem por cadastro novo nem por troca de área.
Regras importantes:
selecao.tipo aceita só lista, com de 1 a 10.000 cliente_ids. Id repetido conta uma vez.
Entra na lista o cliente da central da Api-Key (da área dela ou cadastrado nela sem área), ativo e do app. Os demais voltam em data.recusados, cada um com o motivo: cliente_nao_encontrado (id inexistente ou de outra central), cliente_inativo ou cliente_fora_do_app.
A resposta é 201 quando todos os ids entram e 207 quando algum é recusado. data.selecao.quantidade_clientes_desafiados é o total que entrou.
Nenhum id aceito responde 400 e o desafio não é criado.
data_hora_inicio e data_hora_fim são em UTC (ISO 8601) e são gravadas no fuso da central. O início precisa estar no futuro, o fim depois do início e fora da meia-noite no horário da central (como no painel), e as duas até 2038-01-19T03:14:07Z.
A central tem no máximo um desafio de passageiro ativo ou programado; com um em andamento, a criação responde 409.
A recompensa é em créditos (valor, creditado na carteira do passageiro ao bater a meta) ou personalizada (descricao, entregue pela central e aprovada no painel), com as mesmas regras do painel.
Não há push na criação: o push do primeiro dia faz o lançamento.
Requer Api-Key (bandeira) + autenticação HTTP Basic de um gestor ativo da bandeira. O cargo do gestor deve ser da central (não de empresa conveniada) e ter a permissão Gerenciar desafios; o Cargo Integrador não tem essa permissão, então use a credencial de um gestor da central. A central precisa ter o desafio de passageiro liberado.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"docs.machine.global","colors":{"primary":"#16A34A","light":"#07C983","dark":"#15803D"},"logo":{"light":"https://mintcdn.com/machine-1192d0e5/AquNKVqn2UPlDege/logo/machine-logo-transparente.png?fit=max\u0026auto=format\u0026n=AquNKVqn2UPlDege\u0026q=85\u0026s=0a79525f77ae29822f8f5d4d85d0a66b","dark":"https://mintcdn.com/machine-1192d0e5/AquNKVqn2UPlDege/logo/machine-logo-transparente.png?fit=max\u0026auto=format\u0026n=AquNKVqn2UPlDege\u0026q=85\u0026s=0a79525f77ae29822f8f5d4d85d0a66b"},"favicon":"https://mintcdn.com/machine-1192d0e5/AquNKVqn2UPlDege/logo/machine-logo-transparente.png?fit=max\u0026auto=format\u0026n=AquNKVqn2UPlDege\u0026q=85\u0026s=0a79525f77ae29822f8f5d4d85d0a66b","navbar":{"links":[{"href":"https://suporte.machine.global/hc/pt-br","label":"Suporte"},{"href":"https://forms.monday.com/forms/e31336bc5a756ce39f08628243720155?r=use1","label":"Envie uma sugestão"}],"primary":{"type":"button","label":"Status Page","href":"https://status.machine.global/"}},"footer":{"socials":{"website":"https://www.gaudium.global/","linkedin":"https://www.linkedin.com/company/gaudiumglobal","instagram":"https://www.instagram.com/gaudium.global","youtube":"https://www.youtube.com/c/GaudiumGlobal","facebook":"https://www.facebook.com/gaudium.global"}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"machine-1192d0e5","hasAudioNarration":false,"actualSubdomain":"machine-1192d0e5","customDomains":["docs.machine.global"],"gitSource":{"type":"github","owner":"gaudiumsoftware","repo":"mintlify-docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"chroma":{"collectionId":"facf1ff6-7c36-47b7-a3d0-50fc07fdd16f","liveDeploymentHistoryId":"6adf9c8dfb40053be08c5ff7","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6adf9c8dfb40053be08c5ff7"},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6adf9c8dfb40053be08c5ff7","clientVersion":"0.0.3969","searchFilterCounts":[{"language":"default","tag":"Referência","count":193},{"language":"default","tag":"Corridas","count":180},{"language":"default","tag":"Entregas","count":169},{"language":"default","tag":"Condutores","count":42},{"language":"default","tag":"Webhooks","count":22},{"language":"default","tag":"Configurações","count":22},{"language":"default","tag":"Solicitação","count":17},{"language":"default","tag":"Dinâmicas","count":17},{"language":"default","tag":"Empresa","count":14},{"language":"default","tag":"Engajamento","count":14}]},"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":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-v7-file-tree","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":"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":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"pause-universal-search-reconcile","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":"per-site-search-delta","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":"editor-private-page-search","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":"editor-nav-generations","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":"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":"byok-sep-25","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":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-agent-model-picker","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","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}],"isAtlas":false,"googleFontsInlined":false},"customCss":[{"filePath":"custom.css","content":"html[data-current-path=\"/\"] .nav-tabs,html[data-current-path=\"/\"] [data-component-part=products-selector-trigger],html[data-current-path=\"/\"] [data-component-part=version-select-trigger],html[data-current-path=\"/pages/v2/welcome\"] .nav-tabs,html[data-current-path=\"/pages/v2/welcome\"] [data-component-part=products-selector-trigger],html[data-current-path=\"/pages/v2/welcome\"] [data-component-part=version-select-trigger]{display:none!important}#sidebar-content div:has(>span+div>.nav-tag-pill){display:block!important}#sidebar-content div:has(>.nav-tag-pill){display:inline-flex!important;vertical-align:middle;margin-left:.25rem}#sidebar-content div:has(>.nav-tag-pill>[data-nav-tag^=\"20\"]:not([data-tag-nova])){display:none!important;margin-left:0!important}#sidebar-content .nav-tag-pill-text[data-nav-tag=\"Em breve\"i]{color:#c2410c;background-color:rgba(234,88,12,.12)}html.dark #sidebar-content .nav-tag-pill-text[data-nav-tag=\"Em breve\"i]{color:#fb923c;background-color:rgba(251,146,60,.16)}#sidebar-content .nav-tag-pill-text{white-space:nowrap;padding-left:.25rem;padding-right:.25rem;font-size:.6rem}.home-cta{--cta-color:#16a34a;--cta-tint:rgba(22, 163, 74, 0.08);display:flex;align-items:center;gap:20px;padding:40px 28px;min-height:170px;border-radius:16px;background:rgba(255,255,255,.02);border:1px solid rgba(255,255,255,.08);border-left:8px solid var(--cta-color);transition:transform .25s ease,box-shadow .25s ease,border-color .25s ease,background .25s ease}.home-cta:hover{transform:translateY(-3px);background:var(--cta-tint);border-color:var(--cta-color);box-shadow:0 12px 24px -10px var(--cta-tint)}.home-cta .home-cta-icon{display:flex;align-items:center;justify-content:center;flex-shrink:0;width:56px;height:56px;border-radius:14px;background:var(--cta-tint);color:var(--cta-color)}.home-cta .home-cta-icon svg{width:30px;height:30px}.home-cta .home-cta-text{display:flex;flex-direction:column;gap:2px}.home-cta .home-cta-text span{font-size:20px;font-weight:700;color:var(--tw-prose-headings)}.home-cta .home-cta-text small{font-size:14px;font-weight:500;opacity:.65}.home-cta .home-cta-arrow{margin-left:auto;color:var(--cta-color);opacity:.7;transition:transform .25s ease,opacity .25s ease}.home-cta:hover .home-cta-arrow{transform:translateX(4px);opacity:1}.home-cta-corridas{--cta-color:#0e9fe0;--cta-tint:rgba(37, 188, 255, 0.1)}.home-cta-entregas{--cta-color:#e02020;--cta-tint:rgba(241, 48, 48, 0.1)}nav[aria-label=Main] li.navbar-link a[href*=\"forms.monday.com\"]{color:#4ade80;font-family:Inter;font-size:var(--bodyMd, 14px);font-style:normal;font-weight:500;line-height:var(--bodyMd, 20px)}.env-switch{--env-cor:#b45309;--env-fundo:rgba(245, 158, 11, 0.14);display:flex;flex-wrap:wrap;align-items:center;gap:6px;padding:4px 6px 8px}html.dark .env-switch{--env-cor:#fbbf24;--env-fundo:rgba(251, 191, 36, 0.16)}.env-switch[data-ambiente=producao]{--env-cor:#15803d;--env-fundo:rgba(22, 163, 74, 0.14)}html.dark .env-switch[data-ambiente=producao]{--env-cor:#4ade80;--env-fundo:rgba(74, 222, 128, 0.16)}.env-switch-label{font-size:.7rem;font-weight:600;letter-spacing:.04em;text-transform:uppercase;opacity:.55;margin-right:2px}.env-switch-option{display:inline-flex;align-items:center;gap:6px;padding:3px 10px;border-radius:999px;border:1px solid rgba(128,128,128,.3);background:0 0;color:inherit;font-size:.78rem;font-weight:500;line-height:1.25rem;opacity:.65;cursor:pointer;transition:opacity .15s ease,background .15s ease,border-color .15s ease}.env-switch-option:hover{opacity:1;background:rgba(128,128,128,.12)}.env-switch-option[aria-pressed=true]{opacity:1;font-weight:700;color:var(--env-cor);border-color:var(--env-cor);background:var(--env-fundo)}.env-switch-dot{width:7px;height:7px;border-radius:50%;border:1.5px solid currentColor}.env-switch-option[aria-pressed=true] .env-switch-dot{background:currentColor}.env-switch-note{margin-left:auto;font-size:.75rem;color:var(--env-cor)}@media (max-width:640px){.env-switch-note{flex-basis:100%;margin-left:0}}header>div[data-detalhes-movido]>:not(:first-child){display:none}.endpoint-detalhes{max-width:none;padding:2px 6px;font-size:.95rem;line-height:1.6}.endpoint-detalhes>:first-child{margin-top:0}.endpoint-detalhes>:last-child{margin-bottom:0}@media (min-width:1024px){html[data-current-path=\"/pages/v2/changelog\"] #sidebar,html[data-current-path=\"/pages/v2/changelog-entregas\"] #sidebar{display:none!important}}.changelog-entry-conteudo{min-width:0}.changelog-badge{max-width:100%}.changelog-badge>span:last-child{min-width:0;overflow-wrap:anywhere}@media (max-width:640px){.changelog-entry{flex-direction:column;gap:12px!important}.changelog-entry-data{flex-direction:row!important;align-items:center!important;gap:10px;min-width:0!important;padding-top:0!important}.changelog-entry-data>div{margin-top:0!important}.changelog-entry-linha{display:none}}"}],"page":{"pagePath":"pages/v2/referencia/desafios-passageiro/endpoint/post","slug":"/pages/v2/referencia/desafios-passageiro/endpoint/post","pageMetadata":{"title":"Criar desafio de passageiro","tag":"2026-10-15","openapi":"pages/v2/openapi-corridas.json POST /desafios-passageiro","description":"Cria um desafio de passageiro para uma lista fechada de clientes da central. Só os clientes da lista veem o desafio no app, contam corridas nele e recebem o push diário; a lista é gravada na criação e não muda depois, nem por cadastro novo nem por troca de área.\n\nRegras importantes:\n- `selecao.tipo` aceita só `lista`, com de 1 a 10.000 `cliente_ids`. Id repetido conta uma vez.\n- Entra na lista o cliente da central da Api-Key (da área dela ou cadastrado nela sem área), ativo e do app. Os demais voltam em `data.recusados`, cada um com o `motivo`: `cliente_nao_encontrado` (id inexistente ou de outra central), `cliente_inativo` ou `cliente_fora_do_app`.\n- A resposta é `201` quando todos os ids entram e `207` quando algum é recusado. `data.selecao.quantidade_clientes_desafiados` é o total que entrou.\n- Nenhum id aceito responde `400` e o desafio não é criado.\n- `data_hora_inicio` e `data_hora_fim` são em UTC (ISO 8601) e são gravadas no fuso da central. O início precisa estar no futuro, o fim depois do início e fora da meia-noite no horário da central (como no painel), e as duas até `2038-01-19T03:14:07Z`.\n- A central tem no máximo um desafio de passageiro ativo ou programado; com um em andamento, a criação responde `409`.\n- A recompensa é em créditos (`valor`, creditado na carteira do passageiro ao bater a meta) ou personalizada (`descricao`, entregue pela central e aprovada no painel), com as mesmas regras do painel.\n- Não há push na criação: o push do primeiro dia faz o lançamento.\n\nRequer Api-Key (bandeira) + autenticação HTTP Basic de um gestor ativo da bandeira. O cargo do gestor deve ser da central (não de empresa conveniada) e ter a permissão `Gerenciar desafios`; o Cargo Integrador não tem essa permissão, então use a credencial de um gestor da central. A central precisa ter o desafio de passageiro liberado.","href":"/pages/v2/referencia/desafios-passageiro/endpoint/post"},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n li: \"li\",\n p: \"p\",\n ul: \"ul\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsx(_components.p, {\n children: \"Cria um desafio de passageiro para uma lista fechada de clientes da central. Só os clientes da lista veem o desafio no app, contam corridas nele e recebem o push diário; a lista é gravada na criação e não muda depois, nem por cadastro novo nem por troca de área.\"\n }), \"\\n\", _jsx(_components.p, {\n children: \"Regras importantes:\"\n }), \"\\n\", _jsxs(_components.ul, {\n children: [\"\\n\", _jsxs(_components.li, {\n children: [_jsx(_components.code, {\n children: \"selecao.tipo\"\n }), \" aceita só \", _jsx(_components.code, {\n children: \"lista\"\n }), \", com de 1 a 10.000 \", _jsx(_components.code, {\n children: \"cliente_ids\"\n }), \". Id repetido conta uma vez.\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [\"Entra na lista o cliente da central da Api-Key (da área dela ou cadastrado nela sem área), ativo e do app. Os demais voltam em \", _jsx(_components.code, {\n children: \"data.recusados\"\n }), \", cada um com o \", _jsx(_components.code, {\n children: \"motivo\"\n }), \": \", _jsx(_components.code, {\n children: \"cliente_nao_encontrado\"\n }), \" (id inexistente ou de outra central), \", _jsx(_components.code, {\n children: \"cliente_inativo\"\n }), \" ou \", _jsx(_components.code, {\n children: \"cliente_fora_do_app\"\n }), \".\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [\"A resposta é \", _jsx(_components.code, {\n children: \"201\"\n }), \" quando todos os ids entram e \", _jsx(_components.code, {\n children: \"207\"\n }), \" quando algum é recusado. \", _jsx(_components.code, {\n children: \"data.selecao.quantidade_clientes_desafiados\"\n }), \" é o total que entrou.\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [\"Nenhum id aceito responde \", _jsx(_components.code, {\n children: \"400\"\n }), \" e o desafio não é criado.\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [_jsx(_components.code, {\n children: \"data_hora_inicio\"\n }), \" e \", _jsx(_components.code, {\n children: \"data_hora_fim\"\n }), \" são em UTC (ISO 8601) e são gravadas no fuso da central. O início precisa estar no futuro, o fim depois do início e fora da meia-noite no horário da central (como no painel), e as duas até \", _jsx(_components.code, {\n children: \"2038-01-19T03:14:07Z\"\n }), \".\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [\"A central tem no máximo um desafio de passageiro ativo ou programado; com um em andamento, a criação responde \", _jsx(_components.code, {\n children: \"409\"\n }), \".\"]\n }), \"\\n\", _jsxs(_components.li, {\n children: [\"A recompensa é em créditos (\", _jsx(_components.code, {\n children: \"valor\"\n }), \", creditado na carteira do passageiro ao bater a meta) ou personalizada (\", _jsx(_components.code, {\n children: \"descricao\"\n }), \", entregue pela central e aprovada no painel), com as mesmas regras do painel.\"]\n }), \"\\n\", _jsx(_components.li, {\n children: \"Não há push na criação: o push do primeiro dia faz o lançamento.\"\n }), \"\\n\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"Requer Api-Key (bandeira) + autenticação HTTP Basic de um gestor ativo da bandeira. O cargo do gestor deve ser da central (não de empresa conveniada) e ter a permissão \", _jsx(_components.code, {\n children: \"Gerenciar desafios\"\n }), \"; o Cargo Integrador não tem essa permissão, então use a credencial de um gestor da central. A central precisa ter o desafio de passageiro liberado.\"]\n })]\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}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Criar desafio de passageiro","tag":"2026-10-15","openapi":"pages/v2/openapi-corridas.json POST /desafios-passageiro","description":"Cria um desafio de passageiro para uma lista fechada de clientes da central. Só os clientes da lista veem o desafio no app, contam corridas nele e recebem o push diário; a lista é gravada na criação e não muda depois, nem por cadastro novo nem por troca de área.\n\nRegras importantes:\n- `selecao.tipo` aceita só `lista`, com de 1 a 10.000 `cliente_ids`. Id repetido conta uma vez.\n- Entra na lista o cliente da central da Api-Key (da área dela ou cadastrado nela sem área), ativo e do app. Os demais voltam em `data.recusados`, cada um com o `motivo`: `cliente_nao_encontrado` (id inexistente ou de outra central), `cliente_inativo` ou `cliente_fora_do_app`.\n- A resposta é `201` quando todos os ids entram e `207` quando algum é recusado. `data.selecao.quantidade_clientes_desafiados` é o total que entrou.\n- Nenhum id aceito responde `400` e o desafio não é criado.\n- `data_hora_inicio` e `data_hora_fim` são em UTC (ISO 8601) e são gravadas no fuso da central. O início precisa estar no futuro, o fim depois do início e fora da meia-noite no horário da central (como no painel), e as duas até `2038-01-19T03:14:07Z`.\n- A central tem no máximo um desafio de passageiro ativo ou programado; com um em andamento, a criação responde `409`.\n- A recompensa é em créditos (`valor`, creditado na carteira do passageiro ao bater a meta) ou personalizada (`descricao`, entregue pela central e aprovada no painel), com as mesmas regras do painel.\n- Não há push na criação: o push do primeiro dia faz o lançamento.\n\nRequer Api-Key (bandeira) + autenticação HTTP Basic de um gestor ativo da bandeira. O cargo do gestor deve ser da central (não de empresa conveniada) e ter a permissão `Gerenciar desafios`; o Cargo Integrador não tem essa permissão, então use a credencial de um gestor da central. A central precisa ter o desafio de passageiro liberado.","href":"/pages/v2/referencia/desafios-passageiro/endpoint/post"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/_mintlify/custom/machine-1192d0e5/33e1594b7166789d/custom.js"],"openApiReferenceData":{"operation":{"summary":"Criar desafio de passageiro","description":"Cria um desafio de passageiro para uma lista fechada de clientes da central. Só os clientes da lista veem o desafio no app, contam corridas nele e recebem o push diário; a lista é gravada na criação e não muda depois, nem por cadastro novo nem por troca de área.\n\nRegras importantes:\n- `selecao.tipo` aceita só `lista`, com de 1 a 10.000 `cliente_ids`. Id repetido conta uma vez.\n- Entra na lista o cliente da central da Api-Key (da área dela ou cadastrado nela sem área), ativo e do app. Os demais voltam em `data.recusados`, cada um com o `motivo`: `cliente_nao_encontrado` (id inexistente ou de outra central), `cliente_inativo` ou `cliente_fora_do_app`.\n- A resposta é `201` quando todos os ids entram e `207` quando algum é recusado. `data.selecao.quantidade_clientes_desafiados` é o total que entrou.\n- Nenhum id aceito responde `400` e o desafio não é criado.\n- `data_hora_inicio` e `data_hora_fim` são em UTC (ISO 8601) e são gravadas no fuso da central. O início precisa estar no futuro, o fim depois do início e fora da meia-noite no horário da central (como no painel), e as duas até `2038-01-19T03:14:07Z`.\n- A central tem no máximo um desafio de passageiro ativo ou programado; com um em andamento, a criação responde `409`.\n- A recompensa é em créditos (`valor`, creditado na carteira do passageiro ao bater a meta) ou personalizada (`descricao`, entregue pela central e aprovada no painel), com as mesmas regras do painel.\n- Não há push na criação: o push do primeiro dia faz o lançamento.\n\nRequer Api-Key (bandeira) + autenticação HTTP Basic de um gestor ativo da bandeira. O cargo do gestor deve ser da central (não de empresa conveniada) e ter a permissão `Gerenciar desafios`; o Cargo Integrador não tem essa permissão, então use a credencial de um gestor da central. A central precisa ter o desafio de passageiro liberado.","requestBody":"f1beb082-4137-458c-9611-3156be9c0aee","responses":{"201":"39ccb774-68a6-489b-b372-f4c2cea176a9","207":"f6a0973f-4e3e-44c1-b882-14514618e050","400":"40fc6129-57d0-4b6c-a0f0-dd2447095feb","401":"10a146df-45fd-4757-b172-ed9f02aaadef","403":"507ed222-8c16-417a-8772-46fdbb94221b","409":"3999146c-b468-47c1-b69b-ef00c5bafd8e"},"method":"post","type":"path","servers":["9c4920a4-c276-4f02-934b-4de27e006413","53dec3ed-ca36-4926-bcff-ac8233a78961"],"security":["d5f82bd9-dd3c-4fd8-8bd0-b5bd0a55219b"],"path":"/desafios-passageiro","baseUrlOptions":["https://api.taximachine.com.br/api/v2/integracao","https://api-vendas.taximachine.com.br/api/v2/integracao"],"title":"Criar desafio de passageiro","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["nome","data_hora_inicio","data_hora_fim","meta_corridas","recompensa","selecao"],"properties":{"nome":{"type":"string","maxLength":30,"description":"Nome do desafio, exibido no app.","example":"Volta ao app","isRequired":true,"uniqueKey":"nome","typeLabel":"string"},"data_hora_inicio":{"type":"string","format":"date-time","description":"Início do desafio em UTC (`YYYY-MM-DDTHH:MM:SSZ`). Precisa estar no futuro.","example":"2026-11-01T03:00:00Z","isRequired":true,"uniqueKey":"data_hora_inicio","typeLabel":"string\u003cdate-time>"},"data_hora_fim":{"type":"string","format":"date-time","description":"Fim do desafio em UTC (`YYYY-MM-DDTHH:MM:SSZ`), depois do início.","example":"2026-11-30T02:59:00Z","isRequired":true,"uniqueKey":"data_hora_fim","typeLabel":"string\u003cdate-time>"},"meta_corridas":{"type":"integer","minimum":1,"maximum":5000,"description":"Corridas finalizadas pelo app que o passageiro precisa fazer para concluir o desafio.","example":3,"isRequired":true,"uniqueKey":"meta_corridas","typeLabel":"integer"},"recompensa":{"type":"object","required":["tipo"],"description":"Recompensa de quem bate a meta.","properties":{"tipo":{"type":"string","enum":["creditos","personalizada"],"description":"`creditos` credita `valor` na carteira do passageiro; `personalizada` é entregue pela central e aprovada no painel.","isRequired":true,"uniqueKey":"recompensa.tipo","typeLabel":"enum\u003cstring>"},"valor":{"type":"number","description":"Valor em créditos. Obrigatório quando `tipo` é `creditos`.","example":15.5,"uniqueKey":"recompensa.valor","typeLabel":"number"},"descricao":{"type":"string","maxLength":100,"description":"Descrição da recompensa. Obrigatória quando `tipo` é `personalizada`.","example":"Camiseta da central","uniqueKey":"recompensa.descricao","typeLabel":"string"}},"isRequired":true,"uniqueKey":"recompensa","typeLabel":"object"},"selecao":{"type":"object","required":["tipo","cliente_ids"],"description":"Público do desafio.","properties":{"tipo":{"type":"string","enum":["lista"],"description":"Só `lista` nesta versão.","isRequired":true,"uniqueKey":"selecao.tipo","typeLabel":"enum\u003cstring>"},"cliente_ids":{"type":"array","minItems":1,"maxItems":10000,"items":{"type":"integer","uniqueKey":"selecao.cliente_ids.items.[INDEX]","typeLabel":"integer"},"description":"Ids dos clientes desafiados, de 1 a 10.000.","example":[83983,83984,83985],"isRequired":true,"uniqueKey":"selecao.cliente_ids","typeLabel":"integer[]"}},"isRequired":true,"uniqueKey":"selecao","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"recompensa_em_creditos":{"title":"recompensa_em_creditos","value":{"nome":"Volta ao app","data_hora_inicio":"2026-11-01T03:00:00Z","data_hora_fim":"2026-11-30T02:59:00Z","meta_corridas":3,"recompensa":{"tipo":"creditos","valor":15.5},"selecao":{"tipo":"lista","cliente_ids":[83983,83984,83985,99]}}},"recompensa_personalizada":{"title":"recompensa_personalizada","value":{"nome":"Desafio de novembro","data_hora_inicio":"2026-11-01T03:00:00Z","data_hora_fim":"2026-11-30T02:59:00Z","meta_corridas":5,"recompensa":{"tipo":"personalizada","descricao":"Camiseta da central"},"selecao":{"tipo":"lista","cliente_ids":[83983,83984]}}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"39ccb774-68a6-489b-b372-f4c2cea176a9":{"description":"Desafio criado com todos os clientes da lista","content":{"application/json":{"schema":{"type":"object","uniqueKey":"","typeLabel":"object"},"example":{"success":true,"data":{"id":215,"nome":"Volta ao app","data_hora_inicio":"2026-11-01T03:00:00Z","data_hora_fim":"2026-11-30T02:59:00Z","meta_corridas":3,"recompensa":{"tipo":"creditos","valor":15.5},"selecao":{"tipo":"lista","quantidade_clientes_desafiados":3},"recusados":[]}},"examples":{"Example":{"title":"Example","value":{"success":true,"data":{"id":215,"nome":"Volta ao app","data_hora_inicio":"2026-11-01T03:00:00Z","data_hora_fim":"2026-11-30T02:59:00Z","meta_corridas":3,"recompensa":{"tipo":"creditos","valor":15.5},"selecao":{"tipo":"lista","quantidade_clientes_desafiados":3},"recusados":[]}}}},"exampleType":"examples"}},"exampleType":"examples"},"f6a0973f-4e3e-44c1-b882-14514618e050":{"description":"Desafio criado; parte dos clientes foi recusada","content":{"application/json":{"schema":{"type":"object","uniqueKey":"","typeLabel":"object"},"example":{"success":true,"data":{"id":215,"nome":"Volta ao app","data_hora_inicio":"2026-11-01T03:00:00Z","data_hora_fim":"2026-11-30T02:59:00Z","meta_corridas":3,"recompensa":{"tipo":"creditos","valor":15.5},"selecao":{"tipo":"lista","quantidade_clientes_desafiados":3},"recusados":[{"cliente_id":99,"motivo":"cliente_nao_encontrado"}]}},"examples":{"Example":{"title":"Example","value":{"success":true,"data":{"id":215,"nome":"Volta ao app","data_hora_inicio":"2026-11-01T03:00:00Z","data_hora_fim":"2026-11-30T02:59:00Z","meta_corridas":3,"recompensa":{"tipo":"creditos","valor":15.5},"selecao":{"tipo":"lista","quantidade_clientes_desafiados":3},"recusados":[{"cliente_id":99,"motivo":"cliente_nao_encontrado"}]}}}},"exampleType":"examples"}},"exampleType":"examples"},"40fc6129-57d0-4b6c-a0f0-dd2447095feb":{"description":"Payload inválido, regra do desafio, nenhum cliente aceito ou gestor sem permissão. O desafio não é criado. Gestor de empresa conveniada recebe o erro de permissão.","content":{"application/json":{"schema":{"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"selecao_invalida":{"title":"selecao_invalida","value":{"success":false,"errors":[{"code":222,"message":"'selecao.tipo': Deve estar dentre os valores: lista"}]}},"lista_acima_do_limite":{"title":"lista_acima_do_limite","value":{"success":false,"errors":[{"code":225,"message":"'selecao.cliente_ids': Deve ter no máximo 10000 itens."}]}},"inicio_no_passado":{"title":"inicio_no_passado","value":{"success":false,"errors":[{"code":0,"message":"'data_hora_inicio': A data/hora de início do desafio não pode ser anterior a momento atual"}]}},"nenhum_cliente_aceito":{"title":"nenhum_cliente_aceito","value":{"success":false,"errors":[{"code":242,"message":"Nenhum dos clientes informados pode participar do desafio."}]}},"sem_permissao":{"title":"sem_permissao","value":{"success":false,"errors":[{"code":68,"message":"O usuário informado não tem permissão para realizar essa operação."}]}},"fim_a_meia_noite":{"title":"fim_a_meia_noite","value":{"success":false,"errors":[{"code":0,"message":"'data_hora_fim': A hora final não pode ser 00:00."}]}}},"exampleType":"examples"}},"exampleType":"examples"},"10a146df-45fd-4757-b172-ed9f02aaadef":{"description":"Usuário ou senha do Basic Auth inválidos","content":{"application/json":{"schema":{"type":"object","uniqueKey":"","typeLabel":"object"},"example":{"success":false,"errors":[{"code":"B5","message":"Usuário e/ou senhas inválidos."}]},"examples":{"Example":{"title":"Example","value":{"success":false,"errors":[{"code":"B5","message":"Usuário e/ou senhas inválidos."}]}}},"exampleType":"examples"}},"exampleType":"examples"},"507ed222-8c16-417a-8772-46fdbb94221b":{"description":"Desafio de passageiro não liberado para a central","content":{"application/json":{"schema":{"type":"object","uniqueKey":"","typeLabel":"object"},"example":{"success":false,"errors":[{"code":240,"message":"O desafio de passageiro não está liberado para esta central."}]},"examples":{"Example":{"title":"Example","value":{"success":false,"errors":[{"code":240,"message":"O desafio de passageiro não está liberado para esta central."}]}}},"exampleType":"examples"}},"exampleType":"examples"},"3999146c-b468-47c1-b69b-ef00c5bafd8e":{"description":"A central já tem um desafio de passageiro ativo ou programado","content":{"application/json":{"schema":{"type":"object","uniqueKey":"","typeLabel":"object"},"example":{"success":false,"errors":[{"code":241,"message":"A central já tem um desafio de passageiro ativo ou programado."}]},"examples":{"Example":{"title":"Example","value":{"success":false,"errors":[{"code":241,"message":"A central já tem um desafio de passageiro ativo ou programado."}]}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"d5f82bd9-dd3c-4fd8-8bd0-b5bd0a55219b":{"basicAuth":{"type":"http","scheme":"basic","scopes":[],"schemeName":"basicAuth"},"ApiKeyAuth":{"type":"apiKey","in":"header","name":"api-key","description":"Obrigatório. Sua chave API.","scopes":[],"schemeName":"ApiKeyAuth"}}},"servers":{"9c4920a4-c276-4f02-934b-4de27e006413":{"url":"https://api.taximachine.com.br/api/v2/integracao"},"53dec3ed-ca36-4926-bcff-ac8233a78961":{"url":"https://api-vendas.taximachine.com.br/api/v2/integracao"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"basic","scopes":[],"schemeName":"basicAuth"},"schema":{"title":"Basic Auth","type":"object","description":"Basic authentication header of the form `Basic \u003cencoded-value>`, where `\u003cencoded-value>` is the base64-encoded string `username:password`.","isRequired":true,"properties":{"username":{"type":"string","uniqueKey":"username","isRequired":true,"typeLabel":"string","deprecated":false},"password":{"type":"string","uniqueKey":"password","isRequired":true,"typeLabel":"string","deprecated":false}},"additionalProperties":false,"deprecated":false},"schemeName":"basicAuth","name":"Authorization"},{"scheme":{"type":"apiKey","in":"header","name":"api-key","description":"Obrigatório. Sua chave API.","scopes":[],"schemeName":"ApiKeyAuth"},"schema":{"title":"api-key","type":"string","description":"Obrigatório. Sua chave API.","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"ApiKeyAuth","name":"api-key"}],"title":"basicAuth \u0026 ApiKeyAuth"}]},"originalFileLocation":"pages/v2/openapi-corridas.json"},"subdomain":"machine-1192d0e5","siteName":"docs.machine.global","title":"Criar desafio de passageiro - docs.machine.global","navMaps":{"firstHrefInVersion":{"v2":{"href":"/pages/v2/referencia/desafios-passageiro/endpoint/post","matchLevel":0},"v1":{"href":"/pages/v1/referencia/introducao","matchLevel":3}},"firstHrefInLanguage":{}},"lastModified":"2026-10-26T18:31:57.909Z","originalFileLocation":"pages/v2/referencia/desafios-passageiro/endpoint/post.mdx"},"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=\"Cria um desafio de passageiro para uma lista fechada de clientes da central. Só os clientes da lista veem o desafio no app, contam corridas nele e recebem o push diário; a lista é gravada na criação e não muda depois, nem por cadastro novo nem por troca de área. Regras importantes: - selecao.tipo aceita só lista, com de 1 a 10.000 cliente_ids. Id repetido conta uma vez. - Entra na lista o cliente da central da Api-Key (da área dela ou cadastrado nela sem área), ativo e do app. Os demais voltam em data.recusados, cada um com o motivo: cliente_nao_encontrado (id inexistente ou de outra central), cliente_inativo ou cliente_fora_do_app. - A resposta é 201 quando todos os ids entram e 207 quando algum é recusado. data.selecao.quantidade_clientes_desafiados é o total que entrou. - Nenhum id aceito responde 400 e o desafio não é criado. - data_hora_inicio e data_hora_fim são em UTC (ISO 8601) e são gravadas no fuso da central. O início precisa estar no futuro, o fim depois do início e fora da meia-noite no horário da central (como no painel), e as duas até 2038-01-19T03:14:07Z. - A central tem no máximo um desafio de passageiro ativo ou programado; com um em andamento, a criação responde 409. - A recompensa é em créditos (valor, creditado na carteira do passageiro ao bater a meta) ou personalizada (descricao, entregue pela central e aprovada no painel), com as mesmas regras do painel. - Não há push na criação: o push do primeiro dia faz o lançamento. Requer Api-Key (bandeira) + autenticação HTTP Basic de um gestor ativo da bandeira. O cargo do gestor deve ser da central (não de empresa conveniada) e ter a permissão Gerenciar desafios; o Cargo Integrador não tem essa permissão, então use a credencial de um gestor da central. A central precisa ter o desafio de passageiro liberado.\">\u003cmeta data-mint-head name=\"application-name\" content=\"docs.machine.global\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/machine-1192d0e5/MrV_AtK7ZzPs6Wb0/_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/machine-1192d0e5/MrV_AtK7ZzPs6Wb0/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/machine-1192d0e5/MrV_AtK7ZzPs6Wb0/_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/machine-1192d0e5/MrV_AtK7ZzPs6Wb0/_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/machine-1192d0e5/MrV_AtK7ZzPs6Wb0/_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/machine-1192d0e5/MrV_AtK7ZzPs6Wb0/_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/machine-1192d0e5/MrV_AtK7ZzPs6Wb0/_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/machine-1192d0e5/MrV_AtK7ZzPs6Wb0/_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/machine-1192d0e5/MrV_AtK7ZzPs6Wb0/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Criar desafio de passageiro - docs.machine.global\">\u003cmeta data-mint-head property=\"og:description\" content=\"Cria um desafio de passageiro para uma lista fechada de clientes da central. Só os clientes da lista veem o desafio no app, contam corridas nele e recebem o push diário; a lista é gravada na criação e não muda depois, nem por cadastro novo nem por troca de área. Regras importantes: - selecao.tipo aceita só lista, com de 1 a 10.000 cliente_ids. Id repetido conta uma vez. - Entra na lista o cliente da central da Api-Key (da área dela ou cadastrado nela sem área), ativo e do app. Os demais voltam em data.recusados, cada um com o motivo: cliente_nao_encontrado (id inexistente ou de outra central), cliente_inativo ou cliente_fora_do_app. - A resposta é 201 quando todos os ids entram e 207 quando algum é recusado. data.selecao.quantidade_clientes_desafiados é o total que entrou. - Nenhum id aceito responde 400 e o desafio não é criado. - data_hora_inicio e data_hora_fim são em UTC (ISO 8601) e são gravadas no fuso da central. O início precisa estar no futuro, o fim depois do início e fora da meia-noite no horário da central (como no painel), e as duas até 2038-01-19T03:14:07Z. - A central tem no máximo um desafio de passageiro ativo ou programado; com um em andamento, a criação responde 409. - A recompensa é em créditos (valor, creditado na carteira do passageiro ao bater a meta) ou personalizada (descricao, entregue pela central e aprovada no painel), com as mesmas regras do painel. - Não há push na criação: o push do primeiro dia faz o lançamento. Requer Api-Key (bandeira) + autenticação HTTP Basic de um gestor ativo da bandeira. O cargo do gestor deve ser da central (não de empresa conveniada) e ter a permissão Gerenciar desafios; o Cargo Integrador não tem essa permissão, então use a credencial de um gestor da central. A central precisa ter o desafio de passageiro liberado.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"docs.machine.global\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.machine.global/pages/v2/referencia/desafios-passageiro/endpoint/post\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://machine-1192d0e5.mintlify.app/_mintlify/api/og/v2?division=Desafios+de+passageiro\u0026amp;title=Criar+desafio+de+passageiro\u0026amp;description=Cria+um+desafio+de+passageiro+para+uma+lista+fechada+de+clientes+da+central.+S%C3%B3+os+clientes+da+lista+veem+o+desafio+no+app%2C+contam+corridas+nele+e+recebem+o+pus\u0026amp;theme=8ab14056844268ad59a08ba7\u0026amp;signature=7aa9d8837f936aa6d2e14505b386b748b7f1aa11414095dc427b06a4f36a6aef\">\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=\"Criar desafio de passageiro - docs.machine.global\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Cria um desafio de passageiro para uma lista fechada de clientes da central. Só os clientes da lista veem o desafio no app, contam corridas nele e recebem o push diário; a lista é gravada na criação e não muda depois, nem por cadastro novo nem por troca de área. Regras importantes: - selecao.tipo aceita só lista, com de 1 a 10.000 cliente_ids. Id repetido conta uma vez. - Entra na lista o cliente da central da Api-Key (da área dela ou cadastrado nela sem área), ativo e do app. Os demais voltam em data.recusados, cada um com o motivo: cliente_nao_encontrado (id inexistente ou de outra central), cliente_inativo ou cliente_fora_do_app. - A resposta é 201 quando todos os ids entram e 207 quando algum é recusado. data.selecao.quantidade_clientes_desafiados é o total que entrou. - Nenhum id aceito responde 400 e o desafio não é criado. - data_hora_inicio e data_hora_fim são em UTC (ISO 8601) e são gravadas no fuso da central. O início precisa estar no futuro, o fim depois do início e fora da meia-noite no horário da central (como no painel), e as duas até 2038-01-19T03:14:07Z. - A central tem no máximo um desafio de passageiro ativo ou programado; com um em andamento, a criação responde 409. - A recompensa é em créditos (valor, creditado na carteira do passageiro ao bater a meta) ou personalizada (descricao, entregue pela central e aprovada no painel), com as mesmas regras do painel. - Não há push na criação: o push do primeiro dia faz o lançamento. Requer Api-Key (bandeira) + autenticação HTTP Basic de um gestor ativo da bandeira. O cargo do gestor deve ser da central (não de empresa conveniada) e ter a permissão Gerenciar desafios; o Cargo Integrador não tem essa permissão, então use a credencial de um gestor da central. A central precisa ter o desafio de passageiro liberado.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://machine-1192d0e5.mintlify.app/_mintlify/api/og/v2?division=Desafios+de+passageiro\u0026amp;title=Criar+desafio+de+passageiro\u0026amp;description=Cria+um+desafio+de+passageiro+para+uma+lista+fechada+de+clientes+da+central.+S%C3%B3+os+clientes+da+lista+veem+o+desafio+no+app%2C+contam+corridas+nele+e+recebem+o+pus\u0026amp;theme=8ab14056844268ad59a08ba7\u0026amp;signature=7aa9d8837f936aa6d2e14505b386b748b7f1aa11414095dc427b06a4f36a6aef\">\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/machine-1192d0e5/MrV_AtK7ZzPs6Wb0/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"docs.machine.global\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#16A34A\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.machine.global/pages/v2/referencia/desafios-passageiro/endpoint/post\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/pages/v2/referencia/desafios-passageiro/endpoint/post.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.machine.global/#organization\",\"name\":\"docs.machine.global\",\"url\":\"https://docs.machine.global\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/machine-1192d0e5/AquNKVqn2UPlDege/logo/machine-logo-transparente.png?fit=max\u0026auto=format\u0026n=AquNKVqn2UPlDege\u0026q=85\u0026s=0a79525f77ae29822f8f5d4d85d0a66b\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.machine.global#website\",\"name\":\"docs.machine.global\",\"url\":\"https://docs.machine.global\",\"publisher\":{\"@id\":\"https://docs.machine.global/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.machine.global/pages/v2/referencia/desafios-passageiro/endpoint/post#webpage\",\"url\":\"https://docs.machine.global/pages/v2/referencia/desafios-passageiro/endpoint/post\",\"name\":\"Criar desafio de passageiro\",\"description\":\"Cria um desafio de passageiro para uma lista fechada de clientes da central. Só os clientes da lista veem o desafio no app, contam corridas nele e recebem o push diário; a lista é gravada na criação e não muda depois, nem por cadastro novo nem por troca de área. Regras importantes: - selecao.tipo aceita só lista, com de 1 a 10.000 cliente_ids. Id repetido conta uma vez. - Entra na lista o cliente da central da Api-Key (da área dela ou cadastrado nela sem área), ativo e do app. Os demais voltam em data.recusados, cada um com o motivo: cliente_nao_encontrado (id inexistente ou de outra central), cliente_inativo ou cliente_fora_do_app. - A resposta é 201 quando todos os ids entram e 207 quando algum é recusado. data.selecao.quantidade_clientes_desafiados é o total que entrou. - Nenhum id aceito responde 400 e o desafio não é criado. - data_hora_inicio e data_hora_fim são em UTC (ISO 8601) e são gravadas no fuso da central. O início precisa estar no futuro, o fim depois do início e fora da meia-noite no horário da central (como no painel), e as duas até 2038-01-19T03:14:07Z. - A central tem no máximo um desafio de passageiro ativo ou programado; com um em andamento, a criação responde 409. - A recompensa é em créditos (valor, creditado na carteira do passageiro ao bater a meta) ou personalizada (descricao, entregue pela central e aprovada no painel), com as mesmas regras do painel. - Não há push na criação: o push do primeiro dia faz o lançamento. Requer Api-Key (bandeira) + autenticação HTTP Basic de um gestor ativo da bandeira. O cargo do gestor deve ser da central (não de empresa conveniada) e ter a permissão Gerenciar desafios; o Cargo Integrador não tem essa permissão, então use a credencial de um gestor da central. A central precisa ter o desafio de passageiro liberado.\",\"dateModified\":\"2026-10-26T18:31:57.909Z\",\"isPartOf\":{\"@id\":\"https://docs.machine.global#website\"},\"breadcrumb\":{\"@id\":\"https://docs.machine.global/pages/v2/referencia/desafios-passageiro/endpoint/post#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.machine.global/pages/v2/referencia/desafios-passageiro/endpoint/post#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"docs.machine.global\",\"item\":\"https://docs.machine.global\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Criar desafio de passageiro\",\"item\":\"https://docs.machine.global/pages/v2/referencia/desafios-passageiro/endpoint/post\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.machine.global/pages/v2/referencia/desafios-passageiro/endpoint/post#apireference\",\"headline\":\"Criar desafio de passageiro\",\"name\":\"Criar desafio de passageiro\",\"description\":\"Cria um desafio de passageiro para uma lista fechada de clientes da central. Só os clientes da lista veem o desafio no app, contam corridas nele e recebem o push diário; a lista é gravada na criação e não muda depois, nem por cadastro novo nem por troca de área. Regras importantes: - selecao.tipo aceita só lista, com de 1 a 10.000 cliente_ids. Id repetido conta uma vez. - Entra na lista o cliente da central da Api-Key (da área dela ou cadastrado nela sem área), ativo e do app. Os demais voltam em data.recusados, cada um com o motivo: cliente_nao_encontrado (id inexistente ou de outra central), cliente_inativo ou cliente_fora_do_app. - A resposta é 201 quando todos os ids entram e 207 quando algum é recusado. data.selecao.quantidade_clientes_desafiados é o total que entrou. - Nenhum id aceito responde 400 e o desafio não é criado. - data_hora_inicio e data_hora_fim são em UTC (ISO 8601) e são gravadas no fuso da central. O início precisa estar no futuro, o fim depois do início e fora da meia-noite no horário da central (como no painel), e as duas até 2038-01-19T03:14:07Z. - A central tem no máximo um desafio de passageiro ativo ou programado; com um em andamento, a criação responde 409. - A recompensa é em créditos (valor, creditado na carteira do passageiro ao bater a meta) ou personalizada (descricao, entregue pela central e aprovada no painel), com as mesmas regras do painel. - Não há push na criação: o push do primeiro dia faz o lançamento. Requer Api-Key (bandeira) + autenticação HTTP Basic de um gestor ativo da bandeira. O cargo do gestor deve ser da central (não de empresa conveniada) e ter a permissão Gerenciar desafios; o Cargo Integrador não tem essa permissão, então use a credencial de um gestor da central. A central precisa ter o desafio de passageiro liberado.\",\"url\":\"https://docs.machine.global/pages/v2/referencia/desafios-passageiro/endpoint/post\",\"mainEntityOfPage\":{\"@id\":\"https://docs.machine.global/pages/v2/referencia/desafios-passageiro/endpoint/post#webpage\"},\"dateModified\":\"2026-10-26T18:31:57.909Z\",\"publisher\":{\"@id\":\"https://docs.machine.global/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.machine.global#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"docs.machine.global\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"docs.machine.global","nav":{"global":null,"products":[{"product":"Corridas","versions":[{"version":"v2","tag":"Nova","tabs":[{"tab":"Referência","groups":[{"group":"Introdução","pages":[{"title":"Introdução","icon":"book-open","href":"/pages/v2/referencia/introducao"},{"title":"Rate limit","icon":"gauge","href":"/pages/v2/referencia/rate-limit"},{"title":"Códigos de erro","icon":"circle-exclamation","href":"/pages/v2/referencia/codigos-de-erro"}]},{"group":"Corridas","pages":[{"title":"Consultar corridas","openapi":"pages/v2/openapi-corridas.json POST /corridas/consultar","href":"/pages/v2/referencia/corridas/endpoint/post-consultar"},{"title":"Consultar corrida","openapi":"pages/v2/openapi-corridas.json GET /corridas/{id}","href":"/pages/v2/referencia/corridas/endpoint/get-by-id"},{"title":"Consultar detalhes da corrida","openapi":"pages/v2/openapi-corridas.json GET /corridas/{id}/detalhes","href":"/pages/v2/referencia/corridas/endpoint/get-detalhes"},{"title":"Consultar recibo da corrida","openapi":"pages/v2/openapi-corridas.json GET /corridas/{id}/recibo","href":"/pages/v2/referencia/corridas/endpoint/get-recibo"},{"title":"Criar corrida","openapi":"pages/v2/openapi-corridas.json POST /corridas","href":"/pages/v2/referencia/corridas/endpoint/post-criar"},{"title":"Criar corrida programada","openapi":"pages/v2/openapi-corridas.json POST /corridas/programadas","href":"/pages/v2/referencia/corridas/endpoint/post-criar-programada"},{"title":"Estimar corrida","openapi":"pages/v2/openapi-corridas.json POST /corridas/estimativas","href":"/pages/v2/referencia/corridas/endpoint/post-estimativas"},{"title":"Estimar corrida para empresa","openapi":"pages/v2/openapi-corridas.json POST /corridas/empresas/{id}/estimativas","href":"/pages/v2/referencia/corridas/endpoint/post-empresa-estimativas"},{"title":"Estimar corrida programada","openapi":"pages/v2/openapi-corridas.json POST /corridas/programadas/estimativas","href":"/pages/v2/referencia/corridas/endpoint/post-programada-estimativas"},{"title":"Listar corridas programadas","openapi":"pages/v2/openapi-corridas.json GET /corridas/programadas","href":"/pages/v2/referencia/corridas/endpoint/get-programadas"},{"title":"Consultar corrida programada","openapi":"pages/v2/openapi-corridas.json GET /corridas/programadas/{id}","href":"/pages/v2/referencia/corridas/endpoint/get-programada-by-id"},{"title":"Cancelar corrida","openapi":"pages/v2/openapi-corridas.json POST /corridas/{id}/cancelar","href":"/pages/v2/referencia/corridas/endpoint/post-cancelar"},{"title":"Cancelar corrida programada","openapi":"pages/v2/openapi-corridas.json POST /corridas/programadas/{id}/cancelar","href":"/pages/v2/referencia/corridas/endpoint/post-cancelar-programada"},{"title":"Consultar posição do condutor na corrida","openapi":"pages/v2/openapi-corridas.json GET /corridas/{id}/condutor/posicao","href":"/pages/v2/referencia/corridas/endpoint/get-posicao-condutor"},{"title":"Consultar status da corrida","openapi":"pages/v2/openapi-corridas.json GET /corridas/{id}/status","href":"/pages/v2/referencia/corridas/endpoint/get-status"},{"title":"Listar centros de custo da empresa","openapi":"pages/v2/openapi-corridas.json GET /corridas/empresas/{id}/centro-custo","href":"/pages/v2/referencia/corridas/endpoint/get-centros-custo"},{"title":"Listar funcionários da empresa","openapi":"pages/v2/openapi-corridas.json GET /corridas/empresas/funcionarios","href":"/pages/v2/referencia/corridas/endpoint/get-funcionarios"}]},{"group":"Clientes","pages":[{"title":"Obter clientes","openapi":"pages/v2/openapi-corridas.json GET /clientes","href":"/pages/v2/referencia/clientes/endpoint/get"},{"title":"Obter cliente","openapi":"pages/v2/openapi-corridas.json GET /clientes/{id}","href":"/pages/v2/referencia/clientes/endpoint/get-by-id"}]},{"group":"Dinâmicas","pages":[{"title":"Obter dinâmicas por área","openapi":"pages/v2/openapi-corridas.json GET /dinamicas/area","href":"/pages/v2/referencia/dinamicas/endpoint/get-area"},{"title":"Obter vértices da área da dinâmica","openapi":"pages/v2/openapi-corridas.json GET /dinamicas/area/{id}/vertices","href":"/pages/v2/referencia/dinamicas/endpoint/get-vertices"},{"title":"Consultar faixas de distância da dinâmica","openapi":"pages/v2/openapi-corridas.json GET /dinamicas/area/{id}/faixas","href":"/pages/v2/referencia/dinamicas/endpoint/get-faixas"},{"title":"Obter dinâmica sem área","openapi":"pages/v2/openapi-corridas.json GET /dinamicas/sem-area","href":"/pages/v2/referencia/dinamicas/endpoint/get-sem-area"},{"title":"Criar dinâmica por área","openapi":"pages/v2/openapi-corridas.json POST /dinamicas/area","href":"/pages/v2/referencia/dinamicas/endpoint/post-area"},{"title":"Atualizar dinâmica por área","openapi":"pages/v2/openapi-corridas.json PATCH /dinamicas/area/{id}","href":"/pages/v2/referencia/dinamicas/endpoint/patch-area"},{"title":"Atualizar vértices da área da dinâmica","openapi":"pages/v2/openapi-corridas.json PATCH /dinamicas/area/{id}/vertices","href":"/pages/v2/referencia/dinamicas/endpoint/patch-vertices"},{"title":"Substituir faixas de distância da dinâmica","openapi":"pages/v2/openapi-corridas.json PUT /dinamicas/area/{id}/faixas","href":"/pages/v2/referencia/dinamicas/endpoint/put-faixas"},{"title":"Ativar/Desativar dinâmica sem área","openapi":"pages/v2/openapi-corridas.json PATCH /dinamicas/sem-area","href":"/pages/v2/referencia/dinamicas/endpoint/patch-sem-area"}]},{"group":"Condutores","pages":[{"title":"Listar condutores","openapi":"pages/v2/openapi-corridas.json GET /condutores","href":"/pages/v2/referencia/condutores/endpoint/get"},{"title":"Listar posição dos condutores livres","openapi":"pages/v2/openapi-corridas.json GET /condutores/posicoes","href":"/pages/v2/referencia/condutores/endpoint/get-posicoes"},{"title":"Listar histórico de punições dos condutores","tag":"2026-10-13","openapi":"pages/v2/openapi-corridas.json GET /condutores/historico-punicoes","href":"/pages/v2/referencia/condutores/endpoint/get-historico-punicoes"},{"title":"Consultar score do condutor","tag":"2026-10-22","openapi":"pages/v2/openapi-corridas.json GET /condutores/{id}/score","href":"/pages/v2/referencia/condutores/endpoint/get-score"},{"title":"Obter condutor","openapi":"pages/v2/openapi-corridas.json GET /condutores/{id}","href":"/pages/v2/referencia/condutores/endpoint/get-by-id"},{"title":"Atualizar condutor parcialmente","openapi":"pages/v2/openapi-corridas.json PATCH /condutores/{id}","href":"/pages/v2/referencia/condutores/endpoint/patch-by-id"},{"title":"Atualizar condutor completo","openapi":"pages/v2/openapi-corridas.json PUT /condutores/{id}","href":"/pages/v2/referencia/condutores/endpoint/put-by-id"},{"title":"Atualizar documento do condutor","openapi":"pages/v2/openapi-corridas.json POST /condutores/{id}/documentos/atualizar","href":"/pages/v2/referencia/condutores/endpoint/post-documentos-atualizar"},{"title":"Consultar requisitos de documentos para cadastro","openapi":"pages/v2/openapi-corridas.json GET /condutores/requisitos-cadastro/documentos","href":"/pages/v2/referencia/condutores/endpoint/get-requisitos-cadastro-documentos"},{"title":"Consultar documentos do condutor","openapi":"pages/v2/openapi-corridas.json GET /condutores/documentos","href":"/pages/v2/referencia/condutores/endpoint/get-documentos"},{"title":"Consultar saldo de créditos do condutor","openapi":"pages/v2/openapi-corridas.json GET /condutores/creditos/saldo","href":"/pages/v2/referencia/condutores/endpoint/get-creditos-saldo"},{"title":"Recarregar créditos do condutor","openapi":"pages/v2/openapi-corridas.json POST /condutores/creditos/recargas","href":"/pages/v2/referencia/condutores/endpoint/post-creditos-recargas"},{"title":"Sacar créditos do condutor","openapi":"pages/v2/openapi-corridas.json POST /condutores/creditos/saques","href":"/pages/v2/referencia/condutores/endpoint/post-creditos-saques"},{"title":"Atualizar áreas de bloqueio em lote","openapi":"pages/v2/openapi-corridas.json PUT /condutores/areas-bloqueio/batch","href":"/pages/v2/referencia/condutores/endpoint/put-areas-bloqueio-batch"},{"title":"Vincular área de permissão ao condutor","openapi":"pages/v2/openapi-corridas.json POST /condutores/{id}/areas-permissao","href":"/pages/v2/referencia/condutores/endpoint/post-areas-permissao"},{"title":"Desvincular área de permissão do condutor","openapi":"pages/v2/openapi-corridas.json DELETE /condutores/{id}/areas-permissao","href":"/pages/v2/referencia/condutores/endpoint/delete-areas-permissao"}]},{"group":"Empresas","pages":[{"title":"Listar empresas","openapi":"pages/v2/openapi-corridas.json GET /empresas","href":"/pages/v2/referencia/empresas/endpoint/get"},{"title":"Obter empresa","openapi":"pages/v2/openapi-corridas.json GET /empresas/{id}","href":"/pages/v2/referencia/empresas/endpoint/get-by-id"},{"title":"Cadastrar empresa","openapi":"pages/v2/openapi-corridas.json POST /empresas","href":"/pages/v2/referencia/empresas/endpoint/post"},{"title":"Atualizar empresa","openapi":"pages/v2/openapi-corridas.json PUT /empresas/{id}","href":"/pages/v2/referencia/empresas/endpoint/put"},{"title":"Atualizar empresas (batch)","openapi":"pages/v2/openapi-corridas.json PUT /empresas/batch","href":"/pages/v2/referencia/empresas/endpoint/put-batch"}]},{"group":"Financeiro","pages":[{"title":"Consultar extrato de créditos","tag":"2026-10-15","openapi":"pages/v2/openapi-corridas.json GET /financeiro/extrato","href":"/pages/v2/referencia/financeiro/endpoint/get-extrato"}]},{"group":"Cupons","pages":[{"title":"Criar cupom","openapi":"pages/v2/openapi-corridas.json POST /cupons","href":"/pages/v2/referencia/cupons/endpoint/post"},{"title":"Criar cupons em lote","tag":"2026-10-06","openapi":"pages/v2/openapi-corridas.json POST /cupons/lote","href":"/pages/v2/referencia/cupons/endpoint/post-lote"},{"title":"Consultar cupons","tag":"2026-09-17","openapi":"pages/v2/openapi-corridas.json GET /cupons","href":"/pages/v2/referencia/cupons/endpoint/get"},{"title":"Desativar cupom","tag":"2026-10-01","openapi":"pages/v2/openapi-corridas.json DELETE /cupons/{id}","href":"/pages/v2/referencia/cupons/endpoint/delete"},{"title":"Consultar cupons disponíveis do cliente","tag":"2026-09-22","openapi":"pages/v2/openapi-corridas.json GET /cupons/cliente/{cliente_id}/disponiveis","href":"/pages/v2/referencia/cupons/endpoint/get-cliente-disponiveis"},{"title":"Listar geradores de cupom","openapi":"pages/v2/openapi-corridas.json GET /cupons/geradores","description":"Retorna a lista de geradores de cupom disponíveis para a bandeira autenticada. Os geradores são necessários para criar novos cupons via `POST /cupons`.","href":"/pages/v2/referencia/cupons/endpoint/get-geradores"}]},{"group":"Desafios de passageiro","pages":[{"title":"Criar desafio de passageiro","tag":"2026-10-15","openapi":"pages/v2/openapi-corridas.json POST /desafios-passageiro","href":"/pages/v2/referencia/desafios-passageiro/endpoint/post"},{"title":"Cancelar desafio de passageiro","tag":"2026-10-15","openapi":"pages/v2/openapi-corridas.json DELETE /desafios-passageiro/{id}","description":"Cancela um desafio de passageiro da central, com o mesmo efeito do cancelamento no painel: a contagem de corridas para, o progresso e as recompensas já creditadas ficam, e quem já tinha corrida contabilizada e ainda não tinha concluído recebe o push de desafio encerrado.\n\nRegras importantes:\n- Vale para qualquer desafio de passageiro da central, criado pela API ou pelo painel.\n- Desafio já cancelado responde `200` sem disparar o push de novo. Repetir a chamada é seguro.\n- Desafio já encerrado (passou de `data_hora_fim`) não é cancelado e responde `409`, como no painel: o cancelamento travaria a aprovação das recompensas personalizadas.\n- Desafio inexistente ou de outra central responde `404`.\n\nRequer Api-Key (bandeira) + autenticação HTTP Basic de um gestor ativo da bandeira, com a permissão `Gerenciar desafios` no cargo da central, como o `POST /desafios-passageiro`.","href":"/pages/v2/referencia/desafios-passageiro/endpoint/delete"}]},{"group":"Configurações","pages":[{"title":"Atualizar configurações","openapi":"pages/v2/openapi-corridas.json PATCH /configuracoes","href":"/pages/v2/referencia/configuracoes/endpoint/patch"},{"title":"Listar tipos de documento","openapi":"pages/v2/openapi-corridas.json GET /configuracoes/tipos-documento","href":"/pages/v2/referencia/configuracoes/endpoint/tipos-documento"},{"title":"Listar áreas geográficas","openapi":"pages/v2/openapi-corridas.json GET /configuracoes/areas-geograficas","href":"/pages/v2/referencia/configuracoes/endpoint/areas-geograficas"},{"title":"Criar área","tag":"2026-10-15","openapi":"pages/v2/openapi-corridas.json POST /configuracoes/areas","href":"/pages/v2/referencia/configuracoes/endpoint/post-areas"},{"title":"Listar categorias","openapi":"pages/v2/openapi-corridas.json GET /configuracoes/categorias","href":"/pages/v2/referencia/configuracoes/endpoint/categorias"},{"title":"Atualizar categoria","openapi":"pages/v2/openapi-corridas.json PUT /configuracoes/categorias/{id}","href":"/pages/v2/referencia/configuracoes/endpoint/put-categorias"},{"title":"Listar tarifas da categoria","openapi":"pages/v2/openapi-corridas.json GET /configuracoes/categorias/{id}/tarifas","href":"/pages/v2/referencia/configuracoes/endpoint/get-categorias-tarifas"},{"title":"Criar tarifa da categoria","openapi":"pages/v2/openapi-corridas.json POST /configuracoes/categorias/{id}/tarifas","href":"/pages/v2/referencia/configuracoes/endpoint/post-tarifas"},{"title":"Editar tarifa da categoria","openapi":"pages/v2/openapi-corridas.json PUT /configuracoes/categorias/{id}/tarifas/{tarifaId}","href":"/pages/v2/referencia/configuracoes/endpoint/put-tarifas"},{"title":"Excluir tarifa da categoria","openapi":"pages/v2/openapi-corridas.json DELETE /configuracoes/categorias/{id}/tarifas/{tarifaId}","href":"/pages/v2/referencia/configuracoes/endpoint/delete-tarifas"},{"title":"Ativar ou desativar saque automático","openapi":"pages/v2/openapi-corridas.json POST /configuracoes/saque-automatico/ativacao","href":"/pages/v2/referencia/configuracoes/endpoint/saque-automatico-ativacao"}]},{"group":"Notificação","pages":[{"title":"Enviar notificação push","openapi":"pages/v2/openapi-corridas.json POST /notificacoes/push","href":"/pages/v2/referencia/notificacao/endpoint/post-push"},{"title":"Enviar notificação push para um passageiro","tag":"2026-07-24","openapi":"pages/v2/openapi-corridas.json POST /notificacoes/push/individual","href":"/pages/v2/referencia/notificacao/endpoint/post-push-individual"},{"title":"Enviar notificação in-app","openapi":"pages/v2/openapi-corridas.json POST /notificacoes/in-app-messaging","href":"/pages/v2/referencia/notificacao/endpoint/post-in-app-messaging"},{"title":"Enviar notificação in-app para um passageiro","tag":"2026-07-24","openapi":"pages/v2/openapi-corridas.json POST /notificacoes/in-app-messaging/individual","href":"/pages/v2/referencia/notificacao/endpoint/post-in-app-messaging-individual"},{"title":"Enviar notificação push para condutores","tag":"2026-09-09","openapi":"pages/v2/openapi-corridas.json POST /notificacoes/condutor/push","href":"/pages/v2/referencia/notificacao/endpoint/post-condutor-push"},{"title":"Enviar notificação push para um condutor","tag":"2026-09-09","openapi":"pages/v2/openapi-corridas.json POST /notificacoes/condutor/push/individual","href":"/pages/v2/referencia/notificacao/endpoint/post-condutor-push-individual"},{"title":"Enviar notificação in-app para condutores","tag":"2026-09-15","openapi":"pages/v2/openapi-corridas.json POST /notificacoes/condutor/in-app-messaging","href":"/pages/v2/referencia/notificacao/endpoint/post-condutor-in-app-messaging"},{"title":"Enviar notificação in-app para um condutor","tag":"2026-09-15","openapi":"pages/v2/openapi-corridas.json POST /notificacoes/condutor/in-app-messaging/individual","href":"/pages/v2/referencia/notificacao/endpoint/post-condutor-in-app-messaging-individual"}]},{"group":"Webhooks","pages":[{"title":"Sobre","icon":"book-open","href":"/pages/v2/referencia/webhooks/sobre"},{"title":"Listar webhooks","openapi":"pages/v2/openapi-corridas.json GET /webhooks","href":"/pages/v2/referencia/webhooks/endpoint/get"},{"title":"Cadastrar webhook","openapi":"pages/v2/openapi-corridas.json POST /webhooks","href":"/pages/v2/referencia/webhooks/endpoint/post"},{"title":"Atualizar webhook","openapi":"pages/v2/openapi-corridas.json PUT /webhooks/{id}","href":"/pages/v2/referencia/webhooks/endpoint/put"},{"title":"Deletar webhook","openapi":"pages/v2/openapi-corridas.json DELETE /webhooks/{id}","href":"/pages/v2/referencia/webhooks/endpoint/delete"},{"title":"Consultar status do webhook","openapi":"pages/v2/openapi-corridas.json GET /webhooks/{id}/status","href":"/pages/v2/referencia/webhooks/endpoint/get-status"}]},{"group":"Mensagens","pages":[{"title":"Enviar mensagem no chat central de condutor","openapi":"pages/v2/openapi-corridas.json POST /mensagens/condutor/broadcast","href":"/pages/v2/referencia/mensagens/endpoint/post-condutor-broadcast"},{"title":"Enviar mensagem privada para condutor","openapi":"pages/v2/openapi-corridas.json POST /mensagens/condutor/{id}","href":"/pages/v2/referencia/mensagens/endpoint/post-condutor-privada"},{"title":"Enviar mensagem no chat central de empresa","openapi":"pages/v2/openapi-corridas.json POST /mensagens/empresa/broadcast","href":"/pages/v2/referencia/mensagens/endpoint/post-empresa-broadcast"},{"title":"Enviar mensagem privada para empresa","openapi":"pages/v2/openapi-corridas.json POST /mensagens/empresa/{id}","href":"/pages/v2/referencia/mensagens/endpoint/post-empresa-privada"},{"title":"Enviar mensagem na corrida como passageiro","tag":"2026-10-01","openapi":"pages/v2/openapi-corridas.json POST /mensagens/corridas/passageiro","href":"/pages/v2/referencia/mensagens/endpoint/post-corrida-passageiro"},{"title":"Listar mensagens da corrida como passageiro","tag":"2026-10-01","openapi":"pages/v2/openapi-corridas.json GET /mensagens/corridas/passageiro/{solicitacao_id}","href":"/pages/v2/referencia/mensagens/endpoint/get-corrida-passageiro"},{"title":"Enviar mensagem na corrida como condutor","tag":"2026-10-01","openapi":"pages/v2/openapi-corridas.json POST /mensagens/corridas/condutor","href":"/pages/v2/referencia/mensagens/endpoint/post-corrida-condutor"},{"title":"Listar mensagens da corrida como condutor","tag":"2026-10-01","openapi":"pages/v2/openapi-corridas.json GET /mensagens/corridas/condutor/{solicitacao_id}","href":"/pages/v2/referencia/mensagens/endpoint/get-corrida-condutor"}]},{"group":"Engajamento","pages":[{"title":"Listar webhooks de engajamento","tag":"2026-10-20","openapi":"pages/v2/openapi-corridas.json GET /engajamento","href":"/pages/v2/referencia/engajamento/endpoint/get"},{"title":"Criar webhook de engajamento","tag":"2026-10-20","openapi":"pages/v2/openapi-corridas.json POST /engajamento","href":"/pages/v2/referencia/engajamento/endpoint/post"},{"title":"Editar webhook de engajamento","tag":"2026-10-20","openapi":"pages/v2/openapi-corridas.json PUT /engajamento/{id}","href":"/pages/v2/referencia/engajamento/endpoint/put"},{"title":"Deletar webhook de engajamento","openapi":"pages/v2/openapi-corridas.json DELETE /engajamento/{id}","href":"/pages/v2/referencia/engajamento/endpoint/delete"},{"group":"Permissões","pages":[{"title":"Adicionar bandeiras e permissões a webhook","tag":"2026-10-20","openapi":"pages/v2/openapi-corridas.json POST /engajamento/{id}/permissoes","href":"/pages/v2/referencia/engajamento/permissoes/endpoint/post"},{"title":"Adicionar/Editar permissões de uma bandeira","tag":"2026-10-20","openapi":"pages/v2/openapi-corridas.json PUT /engajamento/{id}/permissoes","href":"/pages/v2/referencia/engajamento/permissoes/endpoint/put"},{"title":"Remover bandeiras de webhook","openapi":"pages/v2/openapi-corridas.json DELETE /engajamento/{id}/permissoes","href":"/pages/v2/referencia/engajamento/permissoes/endpoint/delete"}]}]},{"group":"Login único","pages":[{"title":"Sobre","icon":"book-open","tag":"Em breve","href":"/pages/v2/referencia/login-unico/sobre"},{"title":"Validar login único","tag":"Em breve","openapi":"pages/v2/openapi-corridas.json POST /login-unico/validar","href":"/pages/v2/referencia/login-unico/endpoint/post-validar"}]}]},{"tab":"Novidades","icon":"sparkles","pages":[{"title":"Novidades","href":"/pages/v2/changelog"}]}]},{"version":"v1","tag":"Antiga","pages":[{"title":"v1","href":"/pages/v1/referencia/introducao"}]}]},{"product":"Entregas","pages":[{"title":"Entregas","href":"/pages/v2/entregas/introducao"}]}]},"title":"Criar desafio de passageiro - docs.machine.global","buildId":"dpl_G8u2B2Ji9qJYF9umedjv293TxycS","deploymentId":"dpl_G8u2B2Ji9qJYF9umedjv293TxycS","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-S3ptrr-V.js","utils-CUxEJy9u.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DavhVrxy.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-B1sOUY6E.js","snippetPresets-C-RLYOrF.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-Duz18EdI.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-DPsbCc6D.js","shallow-B1dlhlOw.js","getApiPlaygroundDisplay-DvOu-BhE.js","CodeSnippet-By8wd64X.js","CodeSnippets-BxVv6TjI.js","Page-BGh0lBck.js","getPastedJson-DOAt9xJn.js","icon-BYg-qtQ2.js","MethodPill-Dtah8ZSz.js","DuplicateIcon-guWfDmh1.js","createIcon-pTGhj_hk.js","DynamicMarkdown-DpsHMHVL.js","SectionHeading-BbutQCjq.js","axios-vUo_bRtp.js","Markdown-DZ-stgDu.js","clsx-Dfme4k4V.js","lib--scc4DXi.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CPNs0ebX.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-3JVAA-i3.js"]}