Skip to main content
This guide explains how to create a Registered User in Merge Agent Handler. Registered Users are how we isolate credentials and how we identify the user interacting with the agent. Each Registered User contains the credentials available for making authenticated tool calls on their behalf. A Registered User can represent your employees, your customers’ employees, your customers’ customers’ employees, or any end user who needs to interact with third-party systems through your agent. We recommend creating a Registered User for each individual — this maintains credential isolation and ensures users can only access what they’re authorized to in their third-party systems.

​
How to create a Registered User

The key components of a Registered User are:
  • Origin User ID: Unique ID of the user of the agent.
  • Origin User Name: The name of the user of the agent
  • Shared Credentials Group: The object that identifies the different groups a user is part of.
    • Origin Company ID: The unique ID of the company of the user.
    • Origin Company Name: The name of the company of the user.
    • Custom Keys: This is an optional identifier / grouping container that you can provide for additional segmentation.

​
POST Request body to Merge Agent Handler:

In your backend, set up a POST request to register the user to the below URL: https://ah-api.merge.dev/api/v1/registered-users You will provide these values in the request to Merge Agent Handler. 
{
"origin_user_id": "customer_A_uuid_1234", // required UUID of user
"origin_user_name": "Yash Gogri", // human-readable user name
"shared_credential_group": {
	"origin_company_id": "Merge_uuid_12345", // optional UUID of the company the user is from 
	"origin_company_name": "Merge", // human-readable name of company
	"custom_groupings": {
		"custom_key_1": "Engineering", // an additional grouping under the Origin Company 
	}
}
}

​
API Response from Merge Agent Handler:

{
"registered_user_id": "f9813dd5-e70b-484c-91d8-00acd6065b07"
}
This ID will be used as part of your MCP Entry URL for when the given Registered User begins to interact with your agent.

​
How to create a Test Registered User

  1. Navigate to the Test Registered Users page in dashboard
  2. Click ”+ Add Test Registered User”
  3. Enter the following information:
    • Name of your test user
    • Unique identifier of your test user
    • Company your user belongs to. You can also create a new company to group the user.
    • Additional groupings of the user (optional)
  4. Click “Create”
add-test-user