Intercom: Retrieve Admin

Get an Intercom admin (teammate) by their ID.

Tool ID: intercom_retrieve_admin

Run this action

Use the TypeScript SDK for one call. Use ctx.tools.execute(...) inside a Play for durable calls, scheduled calls, or CSV processing.

import { Deepline } from 'deepline';

const deepline = await Deepline.connect();
const result = await deepline.tools.execute(
  'intercom_retrieve_admin',
  {
    "admin_id": 123
  },
);

console.log(result.toolResponse.raw);

CLI

deepline tools execute intercom_retrieve_admin --input '{
  "admin_id": 123
}' --json

Example response

The SDK returns this shape at result.toolResponse.raw. The example values illustrate the response.

{
  "data": {
    "type": "example",
    "id": "id_123",
    "name": "Example"
  }
}

Use deepline describe intercom_retrieve_admin --json for the latest machine-readable contract.

Input reference

You can retrieve the details of a single admin.

Name	Type	Required	Default	Details
`payload.admin_id`	`integer`	Yes	—	The unique identifier of a given admin

Output reference

Standard tool result payload.

Name	Type	Required	Default	Details
`result.data`	`object`	Yes	—	Admins are teammate accounts that have access to a workspace.
`result.data.type`	`string`	No	—	String representing the object’s type. Always has the value `admin`.
`result.data.id`	`string`	No	—	The id representing the admin.
`result.data.name`	`string`	No	—	The name of the admin.
`result.data.email`	`string`	No	—	The email of the admin.
`result.data.job_title`	`string`	No	—	The job title of the admin.
`result.data.away_mode_enabled`	`boolean`	No	—	Identifies if this admin is currently set in away mode.
`result.data.away_mode_reassign`	`boolean`	No	—	Identifies if this admin is set to automatically reassign new conversations to the apps default inbox.
`result.data.away_status_reason_id`	`integer \| null`	No	—	The unique identifier of the away status reason
`result.data.has_inbox_seat`	`boolean`	No	—	Identifies if this admin has a paid inbox seat to restrict/allow features that require them.
`result.data.team_ids`	`array`	No	—	This object represents the avatar associated with the admin.
`result.data.avatar`	`string \| null`	No	—	Image for the associated team or teammate Format: `uri`.
`result.data.team_priority_level`	`object \| null`	No	—	Admin priority levels for teams
`result.data.team_priority_level.primary_team_ids`	`array \| null`	No	—	The primary team ids for the team
`result.data.team_priority_level.secondary_team_ids`	`array \| null`	No	—	The secondary team ids for the team
`result.meta`	`object`	No	—	Additional response metadata (status, paging).

Deepline cost

Pricing model: fixed (per call).
Estimated Deepline credits: 0 per pricing unit.
Provider-native pricing may still exist outside Deepline credit billing.

​Run this action

​CLI

​Example response

​Input reference

​Output reference

​Deepline cost

​Related documentation

Run this action

CLI

Example response

Input reference

Output reference

Deepline cost

Related documentation