Grade us

Grade us is a comprehensive review management platform designed specifically for marketing agencies, providing tools to collect, monitor, and respond to customer reviews across multiple platforms, helping agencies maintain their online reputation and improve client satisfaction.

Power end-to-end data operations for your Grade us API with Nexla. Our bi-directional Grade us connector is purpose-built for Grade us, making it simple to ingest data, sync it across systems, and deliver it anywhere — all with no coding required. Nexla turns API-sourced data into ready-to-use, reusable data products and makes it easy to send data to Grade us or any other destination. With comprehensive monitoring, lineage tracking, and access controls, Nexla keeps your Grade us workflows fast, secure, and fully governed.

Features

Type: API

SourceDestination

• Seamless API Integration: Connect to any endpoint as source or destination without coding, with automatic data product creation
• Visual Composition & Chaining: Build complex integrations using visual templates, chain API calls, and compose workflows with data validation and filtering
• API Proxy: Expose curated slices of your data securely with a secure and customizable API proxy that validates and transforms data on the fly
• Request optimization with intelligent batching, retry, and caching to minimize API calls and costs

Prerequisites

Before creating a Grade us credential, you need to obtain an API key from your Grade us account. The API key is required to authenticate with the Grade us API.

To obtain your API key, you need to have a Grade us account. Once you have access to your account, you can view and manage your API keys in your account settings. The API key is sent in the Authorization header for all API requests to the Grade us API. For detailed information about API key setup and authentication, refer to the Grade.us API documentation.

Authenticate

Credentials required

Field	Required	Secret	Description
API Key Value	Yes	Yes

Create a credential in Nexla

1. After selecting the data source/destination type, click the Add Credential tile to open the Add New Credential overlay.

New Credential Overlay – Grade us

2. Enter a name for the credential in the Credential Name field and a short, meaningful description in the Credential Description field.

3. Enter your Grade us API key in the API Key Value field. This is the API key you obtained from your Grade us account settings. The API key is sent in the Authorization header for all API requests to the Grade us API.

   Keep your API key secure and do not share it publicly. The API key provides access to your Grade us account and should be treated as sensitive information. You can view and manage API keys in your Grade us account settings. The API key is sent in the Authorization header for all API requests to the Grade us API. For detailed information about obtaining and managing API keys, see the Grade.us API documentation.

4. Click the Save button at the bottom of the overlay. The newly added credential will now appear in a tile on the Authenticate screen during data source/destination creation.

Use as a data source

To create a new data flow, navigate to the Integrate section, and click the New Data Flow button. Select the Grade us connector tile, then select the credential that will be used to connect to the Grade us account, and click Next; or, create a new Grade us credential for use in this flow.

Endpoint templates

Nexla provides pre-built templates that can be used to rapidly configure data sources to ingest data from common Grade us endpoints. Select the endpoint from which this source will fetch data from the Endpoint pulldown menu. Available endpoint templates are listed in the expandable boxes below.

Get Profiles

This endpoint will return a list of all Profiles associated with the account.

• This endpoint automatically retrieves all profiles associated with your Grade us account. No additional configuration is required beyond selecting this endpoint template.
• The endpoint uses GET requests to https://grade.us/api/v4/profiles/. The endpoint URL is automatically constructed based on the Grade.us API base URL.
• The endpoint uses incrementing page-based pagination (iteration.type: paging.incrementing) starting from page 1. The response data path is $.profiles[*], which extracts all items from the profiles array in the API response. Additional pagination metadata is also included from $.pagination.
• The endpoint expects 50 rows per page and automatically fetches additional pages as needed until all profiles have been retrieved.

This endpoint retrieves all profiles associated with your Grade us account. Profiles represent review management profiles that you can use to collect and manage customer reviews. The endpoint supports pagination through incrementing page numbers, which allows you to retrieve large lists of profiles efficiently. The response includes pagination metadata that indicates the current page and total pages available. For detailed information about the API response format and available fields, see the Grade.us API documentation.

Get Users

Get a collection of all users that belongs to a master user.

• This endpoint automatically retrieves all users that belong to a master user in your Grade us account. No additional configuration is required beyond selecting this endpoint template.
• The endpoint uses GET requests to https://grade.us/api/v4/users. The endpoint URL is automatically constructed based on the Grade.us API base URL.
• The endpoint uses incrementing page-based pagination (iteration.type: paging.incrementing) starting from page 1. The response data path is $.users[*], which extracts all items from the users array in the API response. Additional pagination metadata is also included from $.pagination.
• The endpoint expects 50 rows per page and automatically fetches additional pages as needed until all users have been retrieved.

This endpoint retrieves all users that belong to a master user in your Grade us account. Users represent individuals who have access to your Grade us account and can manage profiles and reviews. The endpoint supports pagination through incrementing page numbers, which allows you to retrieve large lists of users efficiently. The response includes pagination metadata that indicates the current page and total pages available. For detailed information about the API response format and available fields, see the Grade.us API documentation.

Once the selected endpoint template has been configured, click the Test button to the right of the endpoint selection menu to retrieve a sample of the data that will be fetched. Sample data will be displayed in the Endpoint Test Result panel on the right, allowing you to verify that the source is configured correctly before saving.

Manual configuration

Grade us data sources can be manually configured to ingest data from any valid Grade us API endpoint. Manual configuration provides maximum flexibility for accessing endpoints not covered by pre-built templates or when you need custom API configurations.

With manual configuration, you can also create more complex Grade us sources, such as sources that use custom query parameters, different HTTP methods, or custom data transformations.

Content Format

1. Select the format in which the data from the Grade us API will be received from the Content Format pulldown menu. Nexla will automatically parse the data in the selected format. The Grade.us API typically returns data in JSON format.

API Endpoint URL

2. Enter the URL of the Grade us API endpoint from which this source will fetch data in the Set API URL field. This should be the complete URL including the protocol (https://) and any required path parameters. Grade.us API endpoints typically follow the pattern https://grade.us/api/v4/{endpoint_path}.

Ensure the API endpoint URL is correct and accessible with your current credentials. You can test the endpoint using the Test button after configuring the URL. The endpoint requires API Key authentication via the Authorization header, which is handled automatically by your credential configuration. For detailed information about Grade.us API endpoints and available APIs, see the Grade.us API documentation.

Use as a destination

Click the + icon on the Nexset that will be sent to the Grade us destination, and select the Send to Destination option from the menu. Select the Grade us connector from the list of available destination connectors, then select the credential that will be used to connect to the Grade us organization, and click Next; or, create a new Grade us credential for use in this flow.

Endpoint templates

Nexla provides pre-built templates that can be used to rapidly configure destinations to send data to common Grade us endpoints. Select the endpoint to which data will be sent from the Endpoint pulldown menu. Then, click on the template in the list below to expand it, and follow the instructions to configure additional endpoint settings.

Create User

This endpoint creates a User. Newly created Users will receive an email asking them to confirm their account and set their password unless send_system_emails is set to "false".

• This endpoint automatically creates a new user in your Grade us account using data from your Nexset. No additional configuration is required beyond selecting this endpoint template.
• The endpoint uses POST requests to https://grade.us/api/v4/users/. The endpoint URL is automatically constructed based on the Grade.us API base URL.
• The endpoint sends data from your Nexset as the request body in JSON format. The request body is automatically formatted according to the schema fields and data mapping you configure. Each record in your Nexset will be sent as a JSON object containing the user data to create.
• Batch mode is disabled by default for this endpoint. Each record in your Nexset will be sent as a separate API request to create a user. If you need to create multiple users, you can send multiple records, but each will be processed as a separate request.
• This endpoint does not automatically create a data source to track the responses received from the Grade.us API after each call.

The request body must be properly formatted JSON that matches the Grade.us API specification for creating users. The endpoint requires API Key authentication via the Authorization header, which is handled automatically by your credential configuration. The Content-Type: application/json header is automatically included in requests. Newly created users will receive an email asking them to confirm their account and set their password unless send_system_emails is set to false in the request body. Batch mode is disabled by default (batch.mode: false), so each record will be sent as a separate request. For detailed information about creating users, including required fields, field names, and request formats, see the Grade.us API documentation.

Create Profile

This endpoint creates a Profile. Certain attributes of a new Profile will be populated by standard defaults, but these attributes can also be sourced from a default profile that can be created manually in the Grade.us application.

• This endpoint automatically creates a new profile in your Grade us account using data from your Nexset. No additional configuration is required beyond selecting this endpoint template.
• The endpoint uses POST requests to https://grade.us/api/v4/profiles/. The endpoint URL is automatically constructed based on the Grade.us API base URL.
• The endpoint sends data from your Nexset as the request body in JSON format. The request body is automatically formatted according to the schema fields and data mapping you configure. Each record in your Nexset will be sent as a JSON object containing the profile data to create.
• Batch mode is disabled by default for this endpoint. Each record in your Nexset will be sent as a separate API request to create a profile. If you need to create multiple profiles, you can send multiple records, but each will be processed as a separate request.
• This endpoint does not automatically create a data source to track the responses received from the Grade.us API after each call.

The request body must be properly formatted JSON that matches the Grade.us API specification for creating profiles. The endpoint requires API Key authentication via the Authorization header, which is handled automatically by your credential configuration. The Content-Type: application/json header is automatically included in requests. Certain attributes of a new profile will be populated by standard defaults, but these attributes can also be sourced from a default profile that can be created manually in the Grade.us application. Batch mode is disabled by default (batch.mode: false), so each record will be sent as a separate request. For detailed information about creating profiles, including required fields, field names, and request formats, see the Grade.us API documentation.

Once the selected endpoint template has been configured, click the Test button to the right of the endpoint selection menu to send a test payload. The result will be displayed in the Endpoint Test Result panel on the right, allowing you to verify that the destination is configured correctly before saving.

Manual configuration

Grade us destinations can be manually configured to send data to any valid Grade us API endpoint. Manual configuration provides maximum flexibility for accessing endpoints not covered by pre-built templates or when you need custom API configurations.

With manual configuration, you can also create more complex Grade us destinations, such as destinations that use custom request headers, different HTTP methods, or custom data formatting.

Content Format

1. Select the format in which the Nexset data will be sent to the Grade us API from the Content Format pulldown menu. Nexla will automatically convert the data to the selected format for each API call. The Grade.us API typically uses JSON format for request bodies.

API Endpoint URL

2. Enter the URL of the Grade us API endpoint to which you want to send the Nexset data in the URL field. This should be the complete URL including the protocol (https://) and any required path parameters. Grade.us API endpoints typically follow the pattern https://grade.us/api/v4/{endpoint_path}.

Ensure the API endpoint URL is correct and accessible with your current credentials. You can test the endpoint using the Test button after configuring the URL. The endpoint requires API Key authentication via the Authorization header, which is handled automatically by your credential configuration. For detailed information about Grade.us API endpoints and available APIs, see the Grade.us API documentation.

Save & activate

Once all endpoint settings have been configured, click the Done button in the upper right corner of the screen to save and create the destination. To send the data to the configured Grade us endpoint, open the destination resource menu, and select Activate.

The Nexset data will not be sent to the Grade us endpoint until the destination is activated. Destinations can be activated immediately or at a later time, providing full control over data movement.