Function: http.post

Sends an HTTPPOST request to the specified URL.

For more information, seeMake an HTTP request.

Arguments

Arguments
url

string

The URL to send the request to.

timeout

float

The request timeout, in seconds (default:300.0). If the request takes longer than the timeout, aTimeoutError is raised. The maximum allowed timeout is1800 seconds.

bodyIf present, the request body (POST requests do generally require a body). If aContent-Type header is not specified and if the body value is bytes, the header is set toContent-Type: application/octet-stream; otherwise, the body is JSON-encoded and the header is set toContent-type: application/json; charset=utf-8.
headersThe HTTP request headers. If present, must be a map of strings. If aContent-Type header is specified, the request body is encoded as prescribed. For example, it might be JSON or URL-encoded.
queryOptional query parameters. If present, must be a map that will get URL-encoded and appended to the URL. The map values must be strings, ints, floats, booleans, or lists of those.
authOptional authentication properties. If present, must be a map withtype attribute in["OIDC", "OAuth2"]. Ascopes key is also supported. For details, seeMake authenticated requests to Google Cloud APIs.
private_service_name

string

If present,private_service_name must be a string that specifies a registered Service Directory service name with formatprojects/my-project/locations/us-east1/namespaces/my-namespace/services/my-service.

ca_certificate

bytes

If present,ca_certificate must be a bytes value describing a custom CA certificate in DER format that will be used in place of the standard certificate pool. The certificate must be signed by a subject alternative name as defined byRFC 3280.

Returns

The HTTP response as a map withbody,code (status code), andheadersattributes.

Raised exceptions

Exceptions
ConnectionErrorIn case of a network problem (DNS failure, truncated response, etc.).
ConnectionFailedErrorWhen the connection is halted during transfer (failed connection, refused connection, etc.).
TimeoutErrorWhen the specified timeout is reached before the response is received.
HttpErrorIf the response status is >= 400.
ValueErrorIf timeout is > 1800. If the URL is invalid or if authType is present and URL is invalid for the given authType. If the private_service_name is invalid. If private_service_name is present and URL contains a port. If ca_certificate is present and not of type bytes.

Examples

# Make a `POST` request to an external HTTP endpoint-send_message:call:http.postargs:url:https://www.example.com/endpointbody:some_val:"HelloWorld"another_val:123result:the_message-return_value:return:${the_message.body}

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2026-02-19 UTC.