Users

Operations related to users

Get Users

get

Retrieves a paginated list of users for the tenant with optional filters. Use metadata=[campo=valor] format for metadata filtering.

Authorizations

x-api-keybearer

x-api-keystringRequired

Query parameters

pagenumberOptional

Page number for pagination (default: 1)

Example: 1

limitnumberOptional

Number of items per page (default: 10)

Example: 10

emailstringOptional

Filter by email (partial match)

Example: [e-mail]

phonestringOptional

Filter by phone (partial match)

Example: [phone]

Responses

200Success

application/json

statusCodenumberRequiredDefault: 200

countnumberRequired

errorstring · nullableRequired

401

Unauthorized - missing or invalid API key or Bearer token

get

/api/v1/users

HTTPcURLJavaScriptPython

GET /api/v1/users HTTP/1.1
Host: api.salescaling.com
x-api-key: YOUR_API_KEY
Accept: */*

{
  "statusCode": 200,
  "count": 1,
  "error": "text",
  "data": [
    {
      "id": "5516cd47-2bd0-4f4f-adc2-22524e54ba4d",
      "email": "[e-mail]",
      "firstName": "John",
      "lastName": "Doe",
      "phone": "[phone]",
      "position": "sales_manager",
      "metadata": {
        "salesRegion": "North",
        "customerId": "12345"
      },
      "personId": "5516cd47-2bd0-4f4f-adc2-22524e54ba4d"
    }
  ]
}

Get User Meetings

get

Returns meetings where the user is the owner and/or a participant (via person linked to the user). Paginated.

Authorizations

x-api-keybearer

x-api-keystringRequired

Path parameters

idstringRequired

User ID to list meetings for.

Query parameters

pagenumberOptional

Page number to retrieve.

limitnumberOptional

Number of items per page.

Responses

200Success

application/json

statusCodenumberRequiredDefault: 200

countnumberRequired

errorstring · nullableRequired

401

Unauthorized - missing or invalid API key or Bearer token

get

/api/v1/users/{id}/meetings

HTTPcURLJavaScriptPython

GET /api/v1/users/{id}/meetings HTTP/1.1
Host: api.salescaling.com
x-api-key: YOUR_API_KEY
Accept: */*

{
  "statusCode": 200,
  "count": 1,
  "error": "text",
  "data": [
    {
      "meetingId": "5516cd47-2bd0-4f4f-adc2-22524e54ba4d",
      "status": "completed",
      "name": "Team Stand-up",
      "startDateTime": "2024-07-15T10:00:00.000Z",
      "endDateTime": "2024-07-15T11:00:00.000Z",
      "duration": 3600,
      "description": "Discuss project progress and next steps",
      "mediaType": "videocall",
      "language": "en",
      "thumbnailUrl": "text",
      "meetingType": {
        "id": "type123",
        "name": "Webinar"
      },
      "aiScore": 0.95,
      "url": "https://app.salescaling.com/meeting/5516cd47-2bd0-4f4f-adc2-22524e54ba4d",
      "calendarEventId": "5516cd47-2bd0-4f4f-adc2-22524e54ba4d"
    }
  ]
}

Update User Metadata

put

Updates the metadata for a specific user

Authorizations

x-api-keybearer

x-api-keystringRequired

Path parameters

idstringRequired

Body

application/json

metadataobjectRequired

Metadata fields to update for the user

Example: {"salesRegion":"South","customerId":"67890"}

Responses

200Success

application/json

statusCodenumberRequiredDefault: 200

countnumberRequired

errorstring · nullableRequired

dataobjectRequired

Updated user metadata

Example: {"salesRegion":"South","customerId":"67890"}

401

Unauthorized - missing or invalid API key or Bearer token

put

/api/v1/users/{id}/metadata

HTTPcURLJavaScriptPython

PUT /api/v1/users/{id}/metadata HTTP/1.1
Host: api.salescaling.com
x-api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 57

{
  "metadata": {
    "salesRegion": "South",
    "customerId": "67890"
  }
}

{
  "statusCode": 200,
  "count": 1,
  "error": "text",
  "data": {
    "salesRegion": "South",
    "customerId": "67890"
  }
}