data—Optional← HomeFleetPay / API
Issue collective invite code for drivers
Parameters, data structure and responses from the versioned contract.
POST
/convites/motoristasTechnical descriptions are translated from the versioned contract. Original identifiers and JSON are preserved; data examples are omitted.
Issues a reusable bearer invite code (valid for 90 days) linking new drivers to the issuing carrier without active message sending. Requires cadastros scope.
Authentication
- Required Scope
cadastros— Registrations- Module
- Base Registrations & Lookups
- Target Profiles
- Shipper · Transport Manager · Dedicated Fleet Contractor · Fleet Carrier
- Schemes
- OAuth2 client_credentials (POST /oauth/token) or API Key via Authorization: Bearer / X-Api-Key
[
{
"oauth2": []
},
{
"chaveApi": []
}
]Availability depends on the environment, enabled scopes and provider. This reference does not execute requests or collect credentials.
Parameters
No parameters declared for this operation.
Responses
201 HTTP Response
Driver collective invite issued.
application/json
metaobject | nullOptionaladditionalPropertiestrueambientestringOptional"homologacao" · "producao"401 HTTP Response
Missing, invalid or cross-environment credential.
403 HTTP Response
Dashboard scope not enabled or resource outside company scope.
Complete Operation Definition
{
"tags": [
"Convites"
],
"operationId": "emitirConviteColetivoMotoristas",
"summary": "Emitir código de convite coletivo para motoristas",
"description": "Emite código de convite reutilizável ao portador (validade de 90 dias) vinculando novos motoristas à transportadora emissora sem envio ativo de mensagens. Exige escopo `cadastros`.",
"responses": {
"201": {
"description": "Convite coletivo de motoristas emitido.",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"data": {
"anyOf": [
{
"type": "object",
"additionalProperties": true
},
{
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
}
]
},
"meta": {
"type": [
"object",
"null"
],
"additionalProperties": true
},
"ambiente": {
"type": "string",
"enum": [
"homologacao",
"producao"
]
}
}
}
}
}
},
"401": {
"description": "Credencial ausente, inválida ou de outro ambiente."
},
"403": {
"description": "Escopo do painel não habilitado ou recurso fora do escopo da company."
}
},
"x-fleetpay-scope": "cadastros",
"x-fleetpay-module": "cadastros-consultas",
"x-fleetpay-profiles": [
"embarcador",
"gestor",
"agregado_empresarial",
"transportador_frotista"
],
"method": "POST",
"path": "/convites/motoristas",
"parameters": []
}