Loading
Salesforce Enforces New Security Requirements in Summer 2026Read More
Optimize and Automate Business Processes with Agentforce Operations
Example Simple Custom HTTP Integration in Agentforce Operations

You are here:

  1. Salesforce Help
  2. Docs
  3. Agentforce Operations

Example Simple Custom HTTP Integration in Agentforce Operations

Walk through an end-to-end example of creating a custom HTTP integration that looks up city and state information for a US postal code, and then adding it to a blueprint as an automation task.

Required Editions

License Required

This feature is a workspace that’s external to your Salesforce org and requires an Agentforce Operations license.

To purchase an Agentforce Operations license, contact your Salesforce account executive.
Role or Access Needed
To manage integrations in Agentforce Operations: Admin role or Integration Admin role
To edit a blueprint in Agentforce Operations: Admin role, Creator role, or a user with Edit access for the blueprint

This example uses the at no additional cost Zippopotam.us API, which returns location information for a US postal code. Authentication isn't required. You create the integration and then add it to a blueprint so the lookup runs automatically when a workflow reaches that stage.

The integration sends a GET request to https://api.zippopotam.us/us/90210 and extracts the city name and state abbreviation from the response.

See Also

Create the Postal Code Lookup Integration

  1. In the navigation sidebar, click Admin.
  2. Click the Integrations tab.
  3. Click Add integration.
  4. For Integration Type, select Custom HTTP.
  5. For Name, enter Postal Code Lookup.
  6. For Type, select None. This API requires no authentication.
  7. For Base URL, enter https://api.zippopotam.us.
  8. For Method, select GET.
  9. For Path, enter /us/90210.
  10. Leave Headers, Query parameters, and Body fields blank.
  11. For HTTP Response, configure the values to extract from the API response.
    1. Click + Add value. For the JSON Path expression, enter .places[0]["place name"]. Select the Agentforce Operations field to store the city name. For example, City.
    2. Click + Add value. For the JSON Path expression, enter .places[0]["state abbreviation"]. Select the Agentforce Operations field to store the state abbreviation. For example, State Abbreviation.
  12. Click Next.
  13. For Health check, select Disabled. The Zippopotam.us API doesn't provide a health endpoint.
  14. Click Create.
    The integration configuration window closes.
  15. In the integration list, find your new integration.
  16. Click the three-dot dropdown list next to the integration and select Edit.
    The integration configuration panel opens.
  17. Open the Test HTTP request section and click Test.
    The test results show the city (Beverly Hills) and state abbreviation (CA) extracted from the response. Confirm that the extracted values appear in the fields you selected.
  18. Close the integration configuration window.

The Postal Code Lookup integration is complete available to use in blueprints.

Add the Postal Code Lookup Integration to a Blueprint

  1. Create a blueprint or edit an existing blueprint.
  2. In the blueprint, in the stage where you want the lookup to run, click + Automation.
  3. Point to Custom HTTP and select Postal Code Lookup.
  4. For Start, select When the stage starts.
  5. Click Add.

The Postal Code Lookup automation task is added to the stage. When a workflow reaches this stage, Agentforce Operations automatically calls the postal code API and populates the city name and state abbreviation fields in the workflow.

 
Loading
Salesforce Help | Article