Skip to main content

​
Overview

The Credentials API allows you to manage system access credentials (accounts) for employees. Credentials are organized by type, department, and unit, making it easy to track and manage access across your organization.

​
Core Concepts

​
Credential (Cuenta)

A credential represents an account that provides access to a specific system or service. Each credential includes:
  • Username/Usuario: The login identifier
  • Password/Clave: The access password (optional for some credential types)
  • Type: Category of the credential (e.g., email, VPN, system access)
  • Department: The department this credential is associated with
  • Unit: The organizational unit this credential belongs to
  • Notes: Additional information about the credential

​
Credential Type (Tipo de Cuenta)

Credential types categorize accounts into different systems or services. Examples:
  • Email accounts
  • VPN access
  • ERP system credentials
  • Third-party service accounts

​
Assignment

Credentials are assigned to:
  • Department: Groups credentials by organizational department
  • Unit: Associates credentials with specific business units
This structure allows you to:
  • Track which credentials belong to which departments
  • Filter credentials by unit or type
  • Manage access centrally

​
Base URL

All credential endpoints are prefixed with: 
/comialex/api/integra/credenciales

​
Authentication

All credential endpoints require JWT authentication. Include the Bearer token in the Authorization header: 
Authorization: Bearer YOUR_JWT_TOKEN
See Authentication for details on obtaining and using tokens.

​
Common Response Format

All endpoints return responses in the standard ResponseData wrapper format: 
{
  "data": <response_data>,
  "message": "Success message",
  "success": true,
  "timestamp": 1709644800000
}

​
Next Steps

Credential Management

Create, update, and delete credentials

Authentication

Learn about API authentication

Build docs developers (and LLMs) love

Get started for freeTalk to us