Create Evaluation Users
Batch create up to 100 organization users at once.
Available to: Organization administrators
Environments: Live
Rate Limit: 100 requests per hour, 1-second back-off, counts failed requests only
firstName and lastName fields exceeding a combined 60 characters are rejected, despite each field individually allowing up to 64 characters.This endpoint can help reduce your application’s API usage footprint. It batches the functionality of several calls at once for each EvaluationUser configuration object:
- Provide a
tradovateSubscriptionPlanIdinteger value matching one of your organization-specific Tradovate Subscription plans to assign that membership to the created user without invoking an additional call. - Provide an
entitlementIdsinteger array to pre-assign entitlement subscriptions with matching IDs to the user. One common use case is assigning your organization’s TradingView entitlement.
entitlementIds. Requests that pass entitlement ID 22 fail, and no users are created. Entitlement ID 22 is deprecated: Group Trading is now standard for any user with two or more accounts in the same environment and no longer requires an entitlement.Use this endpoint when creating new users to minimize API traffic.
Users are created individually. When a single user fails to create, that user’s entry in the results array contains an errorText describing the failure, and the remaining users are still created; each successful entry includes the new user’s userId.
Common Failure Scenarios
- The
usersarray is empty or contains more than 100 entries. - A
tradovateSubscriptionPlanIdorentitlementIdsvalue doesn’t match a plan or entitlement available to your organization. This fails the entire request; no users are created. - A user’s combined
firstNameandlastNameexceeds 60 characters. - Your organization is not currently allowed to add new users.
Error Messages
Access failures reject the whole request and are returned as an HTTP 401 response with the message text as the response body:
Note: This endpoint replaces /user/signUpOrganizationMember, /user/addTradovateSubscription, and /userPlugin/addEntitlementSubscription.
Authentication
Bearer authentication of the form Bearer <token>, where token is your auth token.
Request
Response
Non-empty if the request failed