---
title: "Create Federal Benefit Enrollment"
method: POST
path: "/createFbEnrollment"
tags: ["Federal Benefit Enrollment"]
---

# Create Federal Benefit Enrollment

`POST /createFbEnrollment`

## Request

- Base URL: `api-{corename}.{env}.gpsrv.com/intserv/4.0/` (relative, and the document’s source URL is not known)
- URL: `api-{corename}.{env}.gpsrv.com/intserv/4.0/createFbEnrollment`
- Auth: none declared

Use the Create Federal Benefit Enrollment endpoint to initiate the process for the specified customer to receive U.S. federal benefit funds via ACH deposit. All enrollments that you initiate with this endpoint are queued into a batch file that is sent regularly (usually daily) to the federal government for processing.

[block:callout]

{
"type": "info",
"title": "Note",
"body": "This endpoint automatically creates a secondary account for benefits deposits that shares its balance with the primary account."
}
[/block]

## Request body `application/x-www-form-urlencoded`

- object
  - `apiLogin` string, required: Web service username, as provided by SoFi Tech Solutions. Pattern: Max 50 characters Example: `"AbC123-9999"`
  - `apiTransKey` string, required: Web service password, as provided by SoFi Tech Solutions. Pattern: Max 15 characters Example: `"4sb62fh6w4h7w34g"`
  - `providerId` integer, required: Your unique provider identifier from SoFi Tech Solutions. Pattern: Max 10 digits Example: `9999`
  - `transactionId` string, required: Supply a globally unique ID to identify this endpoint request ("transaction"). Might be used for <a href="ref:idempotency#endpoints-that-use-transactionid-for-idempotency" target="_blank">idempotency</a>. A UUID is preferred. Pattern: Maximum 60 characters Example: `"9845dk-39fdk3fj3-4483483478"`
  - `accountNo` string, required: The <<glossary:PRN>> or <<glossary:PAN>> of the account. Pattern: PAN or PRN Example: `"074103447228"`
  - `location` string, required: Unique location identifier; see location types. Pattern: Must be a number if type is 0; Must be less than 15 characters if type is 1. Example: `"a455-3483"`
  - `locationType` 0 | 1 | 2, required: 0=SoFi Tech Solutions location ID 1=Partner Location ID Pattern: `0` or `1` Example: `1`
  - `recipientType` integer, required: Specifies whether the owner of the account in `accountNo` is a direct recipient or a beneficiary: * `0` &mdash; Direct recipient * `1` &mdash; Beneficiary Pattern: Integer Example: `1`
  - `firstName` string, required: Account holder's first name. <a href="ref:api-reference-special-characters" target="_blank">Special character support</a>. Pattern: 1&ndash;40 characters: letters (`A-Z`, `a-z`), spaces, hyphens (`-`) and single quotes (`'`) Example: `"Ed"`
  - `lastName` string, required: Account holder's last name. <a href="ref:api-reference-special-characters" target="_blank">Special character support</a>. Pattern: 1&ndash;40 characters: letters (`A-Z`, `a-z`), spaces, hyphens (`-`) and single quotes (`'`) Example: `"Harley"`
  - `ssn` string, required: The Social Security number of the direct recipient of the disbursement. Pattern: 9-digit Social Security number, no hyphens Example: `"123456789"`
  - `agencyType` string, required: One of several defined agency types. Pattern: See the <a href="ref:api-reference-federal-benefit-enrollment-agency-types" target="_blank">Federal Benefit Enrollment Agency Types</a> table in Enumerations. Example: `"SOCIAL SECURITY"`
  - `alerts` 0 | 1, nullable: Specifies whether to send alerts regarding the enrollment process. Pattern: Integer Example: `1`
  - `agentId` integer, nullable: Identifier of the agent, for use in transaction reporting and tracking. Pattern: Integer Example: `109405`
  - `middleName` string, nullable: Middle name of the beneficiary.Middle names are not used in ENR transactions, but they are included here for parity between the Account Management and Federal Benefit Enrollment data models. Pattern: String Example: `James`

## Response `default`

- object
  - `status_code` integer, nullable, required: The response status code. May return a string for some statuses.
  - `status` string, nullable, required: The condition of a process or response
  - `processing_time` number, float, nullable, required: The time elapsed in processing the transaction
  - `echo` object, nullable, required: A structure that contains transaction ID information
    - `transaction_id` string, nullable, required: An ID that represents an API transaction
    - `provider_timestamp` string, date-time, nullable, required: Store a related timestamp for reporting and troubleshooting purposes
    - `provider_transaction_id` string, nullable, required: Secondary transaction identifier (generated by a provider)
  - `system_timestamp` string, date-time, nullable, required: A system generated timestamp
  - `rtoken` string, nullable, required: A system-generated ID used for tracking
  - `errors` string[]: A list of errors generated while the request was processed
  - `response_data` object, nullable, required: A structure for the response data. It can be empty but usually will contain information.
    - `fbe_status_id` string, required: Federal benefit enrollment ID

## Changes

- **2026-11-03** `1ede7567a879`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/galileo-ft/apis/program-api/changes/createFbEnrollment/post.md)

---

[API](https://skmtc.dev/galileo-ft/apis/program-api.md) - [All operations](https://skmtc.dev/galileo-ft/apis/program-api/llms.txt) - [OpenAPI document](https://skmtc.dev/galileo-ft/apis/program-api/revisions/1ede7567a879?raw)