> ## Documentation Index
> Fetch the complete documentation index at: https://deepline.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Zoho CRM: Portal Users Transfer Portal Users

> Move Zoho CRM portal users from one user type to another in the same portal. Includes SDK V2 examples, input constraints, response fields, and Deepline cost.

Move Zoho CRM portal users from one user type to another in the same portal.

> [!NOTE]
>
> Tool ID: `zoho_crm_portal_users_transfer_portal_users`

## 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.

```ts theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
import { Deepline } from 'deepline';

const deepline = await Deepline.connect();
const result = await deepline.tools.execute(
  'zoho_crm_portal_users_transfer_portal_users',
  {
    "portal": "example",
    "userType": "example",
    "transfer_To": "example",
    "personality_ids": "personality_123"
  },
);

console.log(result.toolResponse.raw);
```

### CLI

```bash theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
deepline tools execute zoho_crm_portal_users_transfer_portal_users --input '{
  "portal": "example",
  "userType": "example",
  "transfer_To": "example",
  "personality_ids": "personality_123"
}' --json
```

## Example response

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

```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
{
  "data": {
    "users": [
      {
        "code": "SUCCESS",
        "details": {
          "personality_id": "personality_123"
        },
        "message": "Example message",
        "status": "success"
      }
    ]
  }
}
```

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

## Input reference

Transferring portal user from one user group to another user group within the same portal.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `payload.portal` | `string` | Yes | — | The unique identifier of the portal Maximum length: 255. |
| `payload.userType` | `string` | Yes | — | The type of portal user to filter by Maximum length: 255. |
| `payload.transfer_To` | `string` | Yes | — | User type identifier Format: `int64`. |
| `payload.personality_ids` | `string` | Yes | — | Comma separated Record ids of portal user with encoded format Format: `int64`. |

<details>
  <summary>Show raw input schema</summary>

  ### Input JSON Schema

  ```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
  {
    "type": "object",
    "description": "Transferring portal user from one user group to another user group within the same portal.",
    "properties": {
      "portal": {
        "type": "string",
        "description": "The unique identifier of the portal",
        "maxLength": 255
      },
      "userType": {
        "type": "string",
        "description": "The type of portal user to filter by",
        "maxLength": 255
      },
      "transfer_To": {
        "type": "string",
        "description": "User type identifier",
        "format": "int64"
      },
      "personality_ids": {
        "type": "string",
        "description": "Comma separated Record ids of portal user with encoded format",
        "format": "int64"
      }
    },
    "required": [
      "portal",
      "userType",
      "transfer_To",
      "personality_ids"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Output reference

Standard tool result payload.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `result.data` | `object` | Yes | — | Response for transferred portal users requests |
| `result.data.users` | `array` | Yes | — | List of transferred portal users responses Maximum items: 100. |
| `result.data.users[].code` | `"SUCCESS"` | Yes | — | Status code indicating user was transferred Allowed: `SUCCESS`. |
| `result.data.users[].details` | `object` | Yes | — | Additional details about the transferred user |
| `result.data.users[].details.personality_id` | `string` | Yes | — | Record id of portal user Maximum length: 255. |
| `result.data.users[].message` | `string` | Yes | — | Success message Maximum length: 1000. |
| `result.data.users[].status` | `"success"` | Yes | — | Status of the response Allowed: `success`. |
| `result.meta` | `object` | No | — | Additional response metadata (status, paging). |

<details>
  <summary>Show raw output schema</summary>

  ### Output JSON Schema

  ```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
  {
    "type": "object",
    "description": "Standard tool result payload.",
    "properties": {
      "data": {
        "type": "object",
        "description": "Response for transferred portal users requests",
        "properties": {
          "users": {
            "type": "array",
            "description": "List of transferred portal users responses",
            "maxItems": 100,
            "items": {
              "type": "object",
              "description": "Portal user transfer response object",
              "properties": {
                "code": {
                  "type": "string",
                  "description": "Status code indicating user was transferred",
                  "enum": [
                    "SUCCESS"
                  ]
                },
                "details": {
                  "type": "object",
                  "description": "Additional details about the transferred user",
                  "properties": {
                    "personality_id": {
                      "type": "string",
                      "description": "Record id of portal user",
                      "maxLength": 255
                    }
                  },
                  "required": [
                    "personality_id"
                  ],
                  "additionalProperties": false
                },
                "message": {
                  "type": "string",
                  "description": "Success message",
                  "maxLength": 1000
                },
                "status": {
                  "type": "string",
                  "description": "Status of the response",
                  "enum": [
                    "success"
                  ]
                }
              },
              "required": [
                "code",
                "details",
                "message",
                "status"
              ],
              "additionalProperties": false
            }
          }
        },
        "required": [
          "users"
        ],
        "additionalProperties": false
      },
      "meta": {
        "type": "object",
        "description": "Additional response metadata (status, paging).",
        "additionalProperties": true
      }
    },
    "required": [
      "data"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Deepline cost

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

## Related documentation

* [SDK V2 quickstart](https://deepline.com/docs/sdk-v2/quickstart.md)
* [SDK reference](https://deepline.com/docs/sdk-v2/sdk-reference.md)
* [Run tools across a CSV](https://deepline.com/docs/sdk-v2/batch-csv.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.