Criar Organização

Este método permite criar uma organização.

Endpoint

MétodoRotaContent-Type
POSThttps://api.tomticket.com/v2.0/organization/newform-data

Autenticação

Este endpoint utiliza autenticação Bearer Token.

Authorization: Bearer SEU_TOKEN_AQUI

Caso ainda não possua um Token de Acesso, consulte o artigo Criação do Token de Acesso.

Parâmetros da requisição

Parâmetros da requisição - Criar Organização

CampoTipoObrigatórioTamanho máximoDescrição
namestringSim250Nome da organização.
emailstringNão250Endereço de e-mail da organização.
phonestringNão30Telefone.
sitestringNão250Site.
manager_see_all_ticketsintegerNão-Permissão para os gerentes da organização poderem visualizar chamados de seus membros. Opções: 0 - Não permite; 1 - Permite.
create_ticketsintegerNão-Permissão para criar chamados. Opções: 0 - Não permite; 1 - Permite.
team_see_all_ticketsintegerNão-Permissão para os membros da organização poderem visualizar chamados de outros membros. Opções: 0 - Não permite; 1 - Permite.
monthly_tickets_quotaintegerNão-Cota mensal para criação de chamados.
mother_organization_idstringNão512Identificador da organização matriz.
portfolio_idstringNão512Identificador da carteira de clientes.
custom_field[id]stringNão-Campo personalizado para cadastro de organização. O campo pode ser obrigatório, dependendo da configuração do cadastro do campo personalizado.
strict_namestringNão1Restringe o cadastro de organizações se já houver uma organização usando o nome enviado. Opções: 0 - Não restringe; 1 - Restringe.
strict_mailstringNão1Restringe o cadastro de organizações se já houver uma organização usando o endereço de e-mail enviado. Opções: 0 - Não restringe; 1 - Restringe.
return_id_if_existsstringNão1Define se será retornado o identificador da organização caso já exista uma organização usando o nome ou endereço de e-mail enviado, quando strict_name e strict_mail forem enviados como verdadeiros. Opções: 0 - Não retorna; 1 - Retorna.

JSON de saída

JSON de saída - Criar Organização

CampoTipoDescrição
errorbooleanInforma se ocorreu um erro na operação.
messagestringDetalhes da operação, caso tenha ocorrido ou não um problema.
successbooleanRetorna true caso a operação tenha sido concluída com sucesso.
idstringRetorna o identificador da nova organização criada.

Possíveis erros

Status HTTPMensagemQuando ocorre
401Token ou valores enviados não autorizados para uso.Quando o token ou os valores enviados não são autorizados para uso.
403Recurso não disponível.Quando o recurso não está disponível.
404Recurso não encontrado.Quando o recurso não é encontrado.

Este artigo foi útil?  
Agradecemos sua avaliação.