Google Address Validation

Overview

Google Address Validation is a Google Cloud API that verifies the accuracy of postal addresses, standardizes their components, and returns geocoding and deliverability information. With the integration in SquadOS, your agents can validate addresses in real time before using them in orders, registrations, or any flow that depends on accurate location data.

• Composio documentation: docs.composio.dev/toolkits/google_address_validation

Authentication

This tool uses API key (API_KEY) to connect.

You will need the following fields:

Field	Required	Description
api_key	Yes	Google Cloud API key with the Address Validation API enabled.

How to get credentials

1. Go to the Google Cloud Console and sign in with your Google account.
2. Create a project (or select an existing one) using the project selector at the top of the page.
3. In the side menu, go to APIs & Services → Library.
4. Search for Address Validation API and click Enable.
5. Go to APIs & Services → Credentials and click + Create Credential → API Key.
6. Copy the generated key — this is the value to use in the api_key field when connecting in SquadOS.

Tip

Restrict the API key to the Address Validation API method in the Google Cloud credential settings to limit its scope and improve security.

How to connect in SquadOS

1. Go to Tools in the side menu (/admin/tools).
2. Open the Available tab and search for Google Address Validation.
3. Click the card to open the details modal and hit Connect.
4. You’re taken to the secure connection page hosted by Composio, where you enter the credentials obtained above.
5. Once done, you’re sent back to SquadOS with the account connected and the tool available for your agents. (Connection-flow details in Organization Tools.)

Available actions

Provide Validation Feedback

GOOGLE_ADDRESS_VALIDATION_PROVIDE_VALIDATION_FEEDBACK

Tool to provide feedback on an address validation attempt. Use after completing an address validation sequence.

Input parameters

Name	Type	Required	Description
conclusion	string (VALIDATION_CONCLUSION_UNSPECIFIED | VALIDATED_VERSION_USED | USER_VERSION_USED | UNVALIDATED_VERSION_USED | UNUSED)	Yes	Outcome of the sequence of validation attempts. Must not be VALIDATION_CONCLUSION_UNSPECIFIED.
responseId	string	Yes	ID of the response this feedback is for; the responseId from the first validateAddress response.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error if any occurred during the execution of the action.
successful	boolean	Yes	Whether or not the action execution was successful.

Validate Address

GOOGLE_ADDRESS_VALIDATION_VALIDATE_ADDRESS

Tool to validate and standardize addresses. Use when you need detailed parsing, geocode, and deliverability verdict of an address.

Input parameters

Name	Type	Required	Description
address	object	Yes	Address to validate; use addressLines for unformatted addresses.
sessionToken	string	No	Autocomplete session token (URL-safe base64, max 36 chars).
enableUspsCass	boolean	No	Enable USPS CASS mode (US/PR only).
languageOptions	object	No	Preview language options.
previousResponseId	string	No	For follow-up requests; omit on first request.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error if any occurred during the execution of the action.
successful	boolean	Yes	Whether or not the action execution was successful.