# Connect GenderAPI.io V2 with Pabbly Connect

> Connect Pabbly Connect to GenderAPI.io V2 for Shopify records. Choose the right connector, send type/value and map data/meta responses, credits and failures.

Canonical HTML: https://www.genderapi.io/blog/pabbly-gender-api-integration

Last reviewed: 2026-09-27

## Choose the Pabbly Connect connection that matches your contract

This guide's HTTP recipe calls GenderAPI.io V2 at https://api.genderapi.io/api/v2/gender. Send type and value in the JSON body; read the estimate from data and the request and billing details from meta. Native connectors have their own contracts, as described below.

Pabbly's public catalog contains an app named Gender API, but the reviewed entry does not identify its provider domain, endpoint version or full response schema. The label alone does not establish that it is GenderAPI.io. Verify the provider and actual fields before choosing a native action.

For an explicit V2 endpoint, use API by Pabbly's custom API request capability. This recipe describes that HTTP request; it does not claim that a native connector has been migrated to V2.

- [Pabbly support: custom REST requests and re-execution](https://forum.pabbly.com/threads/how-to-track-node-level-logs-enable-retries-and-use-rest-api-integrations-in-pabbly-connect.214474/)
- [Existing V1 reference](https://www.genderapi.io/api-documentation/v1)

## Prepare the account and source record

This example enriches Shopify records using a name. You need access to the source and destination apps, a GenderAPI.io account key, and the platform features used by the HTTP action. No working credentials or connected accounts are supplied by this guide.

V1 and V2 use the same account key and balance. Verify the key through GET /api/v2/usage before setting up a billable lookup, and check that meta.access.mode is api_key in that endpoint's response. A missing or unrecognized key can fall back to a shared IP trial; it should not silently power a production automation.

Keep the workflow disabled while configuring it. Sending a test prediction still uses normal credits. These instructions were reviewed against public documentation and the V2 contract; an authenticated end-to-end platform workflow was not executed for this publication.

- [Authentication and the free usage check](https://www.genderapi.io/docs/v2/authentication#environment-setup)

## Configure the GenderAPI.io V2 request in Pabbly Connect

- Choose the Shopify trigger for the customer event you need and capture one representative test record. Retain the customer ID and map an available first-name field. Skip an empty name rather than substituting the customer's entire record.
- Add API by Pabbly and select Custom Request. Choose POST and the V2 URL below. Configure Bearer token authentication with your GenderAPI key, or an Authorization header whose complete value is Bearer YOUR_API_KEY; do not configure both mechanisms.
- Set Content-Type to application/json. Custom Request exposes a Data field for the JSON body. Construct an object with type = name, value = the mapped first name, and an options object containing ai_mode = off.
- Keep options nested. If the selected action offers only raw JSON, ensure mapped quotes, backslashes and line breaks are correctly JSON-escaped; use a supported JSON construction step rather than interpolating unescaped customer text.

| HTTP setting | Value | Purpose |
| --- | --- | --- |
| `Method` | `POST` | Submit one prediction request. |
| `URL` | `https://api.genderapi.io/api/v2/gender` | The GenderAPI.io V2 single-prediction endpoint. |
| `Authorization` | `Bearer YOUR_API_KEY` | Replace the placeholder using the platform's authentication/header controls. |
| `Content-Type` | `application/json` | Send an object with a nested options object, not form fields. |
| `options.ai_mode` | `off` | A deliberate dataset-only first test; normal charge is 1 credit, even if unknown. |

## Check the JSON body before sending

This is a static input illustration, not a predicted result. First verify the request shape; then replace value with the mapped source field using proper JSON serialization. Do not paste platform mapping expressions into the API as literal strings.

For another input, set type to name, email or username and provide the corresponding value. Add country only when reliable context is available; it is optional and is not a country-of-residence lookup.

**Pabbly Connect request to GenderAPI.io V2**

```json
{
  "type": "name",
  "value": "Alice",
  "options": {
    "ai_mode": "off"
  }
}
```

- [All request fields, types and defaults](https://www.genderapi.io/docs/v2/request-parameters)

## Inspect the HTTP step before enabling updates

Inspect the captured response body and ensure the next step reads the V2 body rather than transport status fields. Pabbly can expose response keys for later mapping; verify their actual path in your workflow.

Run only the selected test action while configuring the flow. A test that sends the request can use GenderAPI credits and platform tasks even before the workflow is enabled.

- [Pabbly support: Custom Request and the Data JSON field](https://forum.pabbly.com/threads/cannot-access-json-body-field-in-api-by-pabbly-module-even-after-correct-settings.29297/)
- [Pabbly public catalog entry (provider unverified)](https://connect.pabbly.com/integrations/gender-api/)

## Route identified, unknown and failed outcomes separately

Parse the response body before choosing a destination update. The JSON paths below refer to the V2 body; your platform may wrap or flatten it. Confirm the actual returned structure with a deliberate test and keep the result attached to the source record ID.

An estimate does not establish a person's identity or self-declared gender. Store it separately from information the person provided. Choose acceptance criteria using evidence for your own workload, and evaluate dataset and AI confidence separately.

| Check | Expected value or type | Workflow decision |
| --- | --- | --- |
| `meta.access.mode` | api_key for this account workflow | Stop on ip_trial; correct the key. A successful trial response does not prove account authentication and may already have used trial credits. |
| `meta.usage.billing_status` | confirmed or unconfirmed | If unconfirmed, retain the request ID and seek billing reconciliation before retrying or proceeding. |
| `data.result_status / data.gender` | identified with male or female; unknown with null | Route accepted identified results to a separate inferred field. Preserve unknowns without assigning a default category. |
| `data.confidence / data.confidence_kind` | number from 0 to 1 or null; evidence kind or null | Interpret observed_frequency and model_reported separately; neither is a universal accuracy guarantee. |
| `data.source / data.sample_count` | dataset, ai or none / integer or null | Retain how the estimate was obtained. AI has no stored sample count; a dataset count is not a product accuracy score. |
| `meta.request_id / meta.usage` | request reference / usage object | Store with your workflow record and result. Keep API keys and unnecessary personal input out of routine logs. |
| `HTTP failure / missing response` | Problem Details or no complete response | Pause the update and inspect error and billing state. A timeout does not prove that the server did no work. |

- [Full V2 response reference](https://www.genderapi.io/docs/v2/responses)
- [Error and retry decisions](https://www.genderapi.io/docs/v2/errors-and-retries)

## Update only the intended Shopify record

Keep the Shopify customer ID from the trigger. Route confirmed identified results to the intended customer field or tag policy, retain unknowns as unknown, and leave the original customer-supplied name unchanged. Store source and confidence_kind with any accepted estimate.

Test the identified, unknown and error branches before enabling updates. You can use synthetic sample responses to exercise branch conditions without issuing another prediction. A destination update should be conditional on the checks above, and should not overwrite unrelated fields or tags.

- [Response fields and unknown outcomes](https://www.genderapi.io/docs/v2/responses)
- [Accuracy and confidence explained](https://www.genderapi.io/accuracy-methodology)
- [Data sources and the dated database profile](https://www.genderapi.io/data-provenance)

## Control replays and repeated charges

Pabbly documents Auto Re-execution and manual choices to re-execute failed/skipped steps or an entire workflow. Review what will run before using either option. Re-executing an entire workflow can repeat a completed GenderAPI lookup; repair a later Shopify failure from the saved response where possible.

Each new GenderAPI request is an independent operation. Deduplicate repeated source events in your own workflow before sending, using a stored source ID and processing state. A source-record ID is not a server-side replay protection key.

A successful unknown is a completed billable result. For a timeout or incomplete response, the result and charge may be unknown; keep the request reference when available and reconcile before resubmitting. Respect Retry-After on rate-limit responses when present.

- [Credit and billing states](https://www.genderapi.io/docs/v2/credits-and-usage)

## Choose when to use AI

forceToGenderize is optional for names, email addresses and usernames. With it enabled, omit ai_mode or use fallback; off and always conflict with it and return 422. A positive starting balance is enough to begin a request even if its final charge takes the balance below zero.

Nickname mode can return a gender with name: null. It can also return an unknown result. Neither ordinary fallback nor nickname inference guarantees a correct or non-null answer.

| Request option | Behavior | Credits for a successful lookup |
| --- | --- | --- |
| options.ai_mode: off | Use the dataset only. | 1, including an unknown result |
| options.ai_mode: fallback | Try the dataset, then ordinary AI when no gender is returned. This is the single-request default. | 1 total, including AI fallback |
| options.ai_mode: always | Ask AI directly. | 2 |
| forceToGenderize: true | Try the dataset first, then allow AI to interpret a personal nickname or alias even without a real given name. | 1 for a resolved dataset result; 2 total if AI is used |

- [AI options and nickname inference](https://www.genderapi.io/docs/v2/ai-options)
- [Credits and usage](https://www.genderapi.io/docs/v2/credits-and-usage)

## Validate the workflow before increasing volume

- Verify the real serialized JSON, parsed output paths, API-key access and confirmed billing with one deliberate test. Test unknown and failure routing with fixtures where possible.
- Confirm which workflow steps retry and which customer fields change. Retain the source record ID, completed response and request reference so a later destination failure does not require another lookup.
- Enable a small controlled run and inspect its records and credits before increasing concurrency. GenderAPI credits and the automation platform's task or operation charges are separate.
- For a batch, use POST /api/v2/gender/batch with up to 50 items for API-key access or 10 for the IP trial. The items array can mix names, emails and usernames, with explicit per-item options and unique IDs. Inspect every result; HTTP 200 may contain partial failures. A native connector's batch support must be checked separately.

- [Batch mapping and partial failures](https://www.genderapi.io/docs/v2/batch)
- [Python implementation guide](https://www.genderapi.io/integrations/python)
- [Node.js implementation guide](https://www.genderapi.io/integrations/javascript)

## Can I use a flat options.ai_mode form field in Pabbly?

The V2 POST body needs a JSON options object. A dot in a field label does not by itself prove the platform nests it. Inspect the serialized body and confirm it matches the example before running the request.

## Does the direct HTTP example allow AI?

The first-request body sets options.ai_mode to off. Change it deliberately to fallback for ordinary AI fallback at 1 credit total, or always for AI at 2 credits. forceToGenderize tries the dataset first and costs 1 credit if resolved there or 2 total when AI is used.

## Is an unknown result free, or safe to retry automatically?

No. A successful unknown is billable and complete. A replay is a new operation. For transport errors or unconfirmed billing, inspect the returned usage and request reference before deciding whether to resubmit.

## Was this workflow executed in a connected account?

No. The platform setup instructions were reviewed against public documentation on 26 September 2026. The GenderAPI.io V2 request and response explanations were reviewed on 27 September 2026. Test the chosen action's current fields, authentication, body, response and retries in your own account before enabling production updates.

## Reference sources

- [Pabbly support: custom REST requests and re-execution](https://forum.pabbly.com/threads/how-to-track-node-level-logs-enable-retries-and-use-rest-api-integrations-in-pabbly-connect.214474/)
- [Pabbly support: Custom Request and the Data JSON field](https://forum.pabbly.com/threads/cannot-access-json-body-field-in-api-by-pabbly-module-even-after-correct-settings.29297/)
- [Pabbly public catalog entry (provider unverified)](https://connect.pabbly.com/integrations/gender-api/)
- [GenderAPI.io V2 request contract](https://www.genderapi.io/docs/v2/request-parameters)
- [GenderAPI.io V2 response contract](https://www.genderapi.io/docs/v2/responses)
- [GenderAPI.io V2 billing and credits](https://www.genderapi.io/docs/v2/credits-and-usage)