Record Assignment

Use this API call to update the user assignment of records within your Shape instance

POST /assign/lead/owner

To assign a user to a lead, send an authorized POST request to


Update the assigned user of a lead with these parameters:

  • lead_id

    Parameter — Lead ID is the record identifier required for finding the lead in database

  • lead_owner_id

    User ID is the user’s identifier required to assign a user to the lead. Find user ID numbers in the "Manage Users" settings page, or use the "Get Users" API call.

Request Header

The authentication token must be passed in the request header for every API request. You can find and generate your authentication token in your system settings page under “API Integrations.”

Request Body

JSON request body formatting example:

  "lead_id": 454688,
  "lead_owner_id": 33


Upon success, the server returns HTTP codes and messages in the header with some additional elements and properties that are set by the server, such as id.

    "msg": "User Assignment: John Doe assigned to Mike Smith",
    "status": 1

Get in Touch

Our team of experts are here to help! Call our sales line at (888) 762-7211


Contact Sales