---
title: "Create an ACH Prenotification"
method: POST
path: "/ach_prenotifications"
---

# Create an ACH Prenotification

`POST /ach_prenotifications`

## Request body

- CreateAnAchPrenotificationParameters
  - `account_id` string, required — The Increase identifier for the account that will send the ACH Prenotification.
  - `account_number` string, required — The account number for the destination account.
  - `addendum` string — Additional information that will be sent to the recipient.
  - `company_descriptive_date` string — The description of the date of the ACH Prenotification.
  - `company_discretionary_data` string — The data you choose to associate with the ACH Prenotification.
  - `company_entry_description` string — The description you wish to be shown to the recipient.
  - `company_name` string — The name by which the recipient knows you.
  - `credit_debit_indicator` 'credit' | 'debit' — Whether the Prenotification is for a future debit or credit.
  - `effective_date` string, date — The ACH Prenotification effective date in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.
  - `individual_id` string — Your identifier for the recipient.
  - `individual_name` string — The name of therecipient. This value is informational and not verified by the recipient's bank.
  - `routing_number` string, required — The American Bankers' Association (ABA) Routing Transit Number (RTN) for the destination account.
  - `standard_entry_class_code` 'corporate_credit_or_debit' | 'corporate_trade_exchange' | 'prearranged_payments_and_deposit' | 'internet_initiated' — The [Standard Entry Class (SEC) code](/documentation/ach-standard-entry-class-codes) to use for the ACH Prenotification.

## Response `200`

ACH Prenotification

- AchPrenotification — ACH Prenotifications are one way you can verify account and routing numbers by Automated Clearing House (ACH).
  - `account_id` string, nullable, required — The account that sent the ACH Prenotification.
  - `account_number` string, required — The destination account number.
  - `addendum` string, nullable, required — Additional information for the recipient.
  - `company_descriptive_date` string, nullable, required — The description of the date of the notification.
  - `company_discretionary_data` string, nullable, required — Optional data associated with the notification.
  - `company_entry_description` string, nullable, required — The description of the notification.
  - `company_name` string, nullable, required — The name by which you know the company.
  - `created_at` string, date-time, required — The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time at which the prenotification was created.
  - `credit_debit_indicator` 'credit' | 'debit', nullable, required — If the notification is for a future credit or debit.
  - `effective_date` string, date-time, nullable, required — The effective date in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.
  - `id` string, required — The ACH Prenotification's identifier.
  - `idempotency_key` string, nullable, required — The idempotency key you chose for this object. This value is unique across Increase and is used to ensure that a request is only processed once. Learn more about [idempotency](https://increase.com/documentation/idempotency-keys).
  - `individual_id` string, nullable, required — Your identifier for the recipient.
  - `individual_name` string, nullable, required — The name of the recipient. This value is informational and not verified by the recipient's bank.
  - `notifications_of_change` object[], required — If the receiving bank notifies that future transfers should use different details, this will contain those details.
    - `change_code` 'incorrect_account_number' | 'incorrect_routing_number' | 'incorrect_routing_number_and_account_number' | 'incorrect_transaction_code' | 'incorrect_account_number_and_transaction_code' | 'incorrect_routing_number_account_number_and_transaction_code' | 'incorrect_receiving_depository_financial_institution_identification' | 'incorrect_individual_identification_number' | 'addenda_format_error' | 'incorrect_standard_entry_class_code_for_outbound_international_payment' | 'misrouted_notification_of_change' | 'incorrect_trace_number' | 'incorrect_company_identification_number' | 'incorrect_identification_number' | 'incorrectly_formatted_corrected_data' | 'incorrect_discretionary_data' | 'routing_number_not_from_original_entry_detail_record' | 'depository_financial_institution_account_number_not_from_original_entry_detail_record' | 'incorrect_transaction_code_by_originating_depository_financial_institution', required — The required type of change that is being signaled by the receiving financial institution.
    - `corrected_data` string, required — The corrected data that should be used in future ACHs to this account. This may contain the suggested new account number or routing number. When the `change_code` is `incorrect_transaction_code`, this field contains an integer. Numbers starting with a 2 encourage changing the `funding` parameter to checking; numbers starting with a 3 encourage changing to savings.
    - `created_at` string, date-time, required — The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time at which the notification occurred.
  - `prenotification_return` object, nullable, required — If your prenotification is returned, this will contain details of the return.
    - `created_at` string, date-time, required — The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time at which the Prenotification was returned.
    - `return_reason_code` 'insufficient_fund' | 'no_account' | 'account_closed' | 'invalid_account_number_structure' | 'account_frozen_entry_returned_per_ofac_instruction' | 'credit_entry_refused_by_receiver' | 'unauthorized_debit_to_consumer_account_using_corporate_sec_code' | 'corporate_customer_advised_not_authorized' | 'payment_stopped' | 'non_transaction_account' | 'uncollected_funds' | 'routing_number_check_digit_error' | 'customer_advised_unauthorized_improper_ineligible_or_incomplete' | 'amount_field_error' | 'authorization_revoked_by_customer' | 'invalid_ach_routing_number' | 'file_record_edit_criteria' | 'enr_invalid_individual_name' | 'returned_per_odfi_request' | 'limited_participation_dfi' | 'incorrectly_coded_outbound_international_payment' | 'account_sold_to_another_dfi' | 'addenda_error' | 'beneficiary_or_account_holder_deceased' | 'customer_advised_not_within_authorization_terms' | 'corrected_return' | 'duplicate_entry' | 'duplicate_return' | 'enr_duplicate_enrollment' | 'enr_invalid_dfi_account_number' | 'enr_invalid_individual_id_number' | 'enr_invalid_representative_payee_indicator' | 'enr_invalid_transaction_code' | 'enr_return_of_enr_entry' | 'enr_routing_number_check_digit_error' | 'entry_not_processed_by_gateway' | 'field_error' | 'foreign_receiving_dfi_unable_to_settle' | 'iat_entry_coding_error' | 'improper_effective_entry_date' | 'improper_source_document_source_document_presented' | 'invalid_company_id' | 'invalid_foreign_receiving_dfi_identification' | 'invalid_individual_id_number' | 'item_and_rck_entry_presented_for_payment' | 'item_related_to_rck_entry_is_ineligible' | 'mandatory_field_error' | 'misrouted_dishonored_return' | 'misrouted_return' | 'no_errors_found' | 'non_acceptance_of_r62_dishonored_return' | 'non_participant_in_iat_program' | 'permissible_return_entry' | 'permissible_return_entry_not_accepted' | 'rdfi_non_settlement' | 'rdfi_participant_in_check_truncation_program' | 'representative_payee_deceased_or_unable_to_continue_in_that_capacity' | 'return_not_a_duplicate' | 'return_of_erroneous_or_reversing_debit' | 'return_of_improper_credit_entry' | 'return_of_improper_debit_entry' | 'return_of_xck_entry' | 'source_document_presented_for_payment' | 'state_law_affecting_rck_acceptance' | 'stop_payment_on_item_related_to_rck_entry' | 'stop_payment_on_source_document' | 'timely_original_return' | 'trace_number_error' | 'untimely_dishonored_return' | 'untimely_return', required — Why the Prenotification was returned.
  - `routing_number` string, required — The American Bankers' Association (ABA) Routing Transit Number (RTN).
  - `standard_entry_class_code` 'corporate_credit_or_debit' | 'corporate_trade_exchange' | 'prearranged_payments_and_deposit' | 'internet_initiated', nullable, required — The [Standard Entry Class (SEC) code](/documentation/ach-standard-entry-class-codes) to use for the ACH Prenotification.
  - `status` 'pending_submitting' | 'requires_attention' | 'returned' | 'submitted', required — The lifecycle status of the ACH Prenotification.
  - `type` 'ach_prenotification', required — A constant representing the object's type. For this resource it will always be `ach_prenotification`.

## Other responses

- `4XX` — Error
- `5XX` — Error

---

[API](https://skmtc.net/increase/apis/increase-api.md) · [All operations](https://skmtc.net/increase/apis/increase-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/increase/increase-api/versions/22125d715935/schema)