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

# RequestUserService

> Request a user-scoped service from the provider

Create a `UserService` request — a generic mechanism for provider-defined user flows (onboarding, KYC, feature activation, etc.). The semantics of `reference_id` and `party_name` are provider-specific.

Invoked through the two-phase [transaction flow](/agentic-api/transaction-flow) with:

* `operation = TRANSACTION_OPERATION_REQUEST_USER_SERVICE`
* `params.request_user_service = RequestUserServiceParams { … }`

## Params

<ParamField path="reference_id" type="string (optional)">
  Provider-defined reference ID.
</ParamField>

<ParamField path="party_name" type="string (optional)">
  Human-readable party name.
</ParamField>

```proto theme={null}
message RequestUserServiceParams {
  optional string reference_id = 1;
  optional string party_name   = 2;
}
```

## See also

* [`GetAgentConfig`](/agentic-api/onboarding/get-agent-config) — discover provider-specific parameters that govern user-service flows.
* [`GetServiceInfo`](/agentic-api/core/get-service-info) — confirm that the `user_service` group is enabled.
* [Transaction flow](/agentic-api/transaction-flow) — two-phase model this call uses.
