Docs & Support

Learn about all the Formidable features and get support from our amazing customer success team.

frm_api_request_args

Heads up!
This article contains PHP code and is intended for developers. We offer this code as a courtesy, but don't provide support for code customizations or 3rd party development.

This hook allows you to do something with the request returned after an API call.

Usage

add_filter( 'frm_api_request_args', 'my_custom_function', 10, 2 );
function my_custom_frm_api_request_header( $arg_array, $args )

Formidable Forms makes advanced site building simple. Launch forms, directories, dashboards, and custom WordPress apps faster than ever before.

Parameters

  • $arg_array
  • $args (array)

Examples

Customize API request headers

Use the following code to customize the headers sent with your API request.

add_filter( 'frm_api_request_args', 'my_custom_frm_api_request_header', 10, 2 );
function my_custom_frm_api_request_header( $arg_array, $args ) {
if ( $args['url'] == 'http://test.com' ) { // the full url where the request is being sent
$arg_array['headers']['my_header_name'] = 'my_header_value';
$arg_array['headers']['another_header_name'] = 'a_header_value';
}
return $arg_array;
}

The existing headers include 'url', 'headers', 'body', 'method', and 'timeout'.

See WP_Http::request() for default arguments information.

Increase timeout for API actions

By default, there is a 15 second timeout for API actions. To increase the timeout for API actions, use the following code example.

add_filter( 'frm_api_request_args', 'extend_api_timeout' );
function extend_api_timeout( $args ) {
$args['timeout'] = 30; // change this
return $args;
}

 

Convert a meta value to an int

Use the following code to convert a specific owner_id meta value to an integer when sending API data.

add_filter( 'frm_api_request_args', 'my_custom_function' );
function my_custom_function( $args ) {
	$body = json_decode( $args['body'], true );
	if ( isset( $body['owner_id'] ) ) {
		$body['owner_id'] = (int) $body['owner_id'];
		$args['body'] = json_encode( $body );
	}
return $args;
}
Was this article helpful? *

This article may contain affiliate links. Once in a while, we earn commissions from those links. But we only recommend products we like, with or without commissions.

In this article

    We have a small, but amazing team of dedicated people who are committed to helping you achieve your goals and project requirements.


    Copyright © 2025 Strategy11, LLC. Formidable Forms® is a registered trademark Strategy11, LLC.

    Complete your purchase
    Special offer unlocked.
    Get 55% OFF!
    Complete Purchase
    Join 400,000+ using Formidable Forms to create form-focused solutions fast. Get Formidable Forms