---
title: "Initiate a push"
method: POST
path: "/{account}/domains/{domain}/pushes"
tags: ["domain pushes"]
---

# Initiate a push

`POST /{account}/domains/{domain}/pushes`

Initiates a pust of a domain to another DNSimple account.

## Path parameters

- `account` integer, required
- `domain` string, required

## Request body

- object
  - `new_account_email` string — Deprecated - use new_account_identifier instead
  - `new_account_identifier` string — The account identifier of the target DNSimple account

## Response `201`

Successfully initiated the push.

- object
  - `data` Push, required
    - `id` integer, required
    - `domain_id` integer, required
    - `contact_id` integer, required
    - `account_id` integer, required
    - `created_at` string, date-time, required — A date-time value, representing when the entry was created, formatted as ISO 8601.
    - `updated_at` string, date-time, required — A date-time value, representing when the entry was last updated, formatted as ISO 8601.
    - `accepted_at` string, date-time, nullable, required — A nullable date-time value. The value can be null, when present the value is formatted according to the ISO 8601 specification.

## Other responses

- `400` — A required parameter is missing or the request is invalid.
- `404` — The requested resource doesn't exist.

## Changes

- **2025-11-26** (v2) `171eb982b16e` — 1 warning, 1 info
  - removed the request property `domain_push_identifier`
  - added the new optional request property `new_account_identifier`
- **2025-11-13** (v2) `79b1b45f5a58` — 2 info
  - added the new optional request property `domain_push_identifier`
  - request property `new_account_email` deprecated
- **2025-07-11** (v2) `06780be0ef17` — 11 info
  - the response property `data` became required for the status `201`
  - the response property `data/accepted_at` became required for the status `201`
  - the response property `data/account_id` became required for the status `201`
  - the response property `data/contact_id` became required for the status `201`
  - …7 more
- **2023-07-18** (v2) `c8591dcf8c29` — 12 breaking, 1 warning, 1 info
  - the response property `data/accepted_at` became nullable for the status `201`
  - the response property `data` became optional for the status `201`
  - the response property `data/accepted_at` became optional for the status `201`
  - the response property `data/account_id` became optional for the status `201`
  - …10 more

[Change history](https://skmtc.dev/dnsimple/apis/dnsimple-api/changes/:account/domains/:domain/pushes/post.md)

---

[API](https://skmtc.dev/dnsimple/apis/dnsimple-api.md) · [All operations](https://skmtc.dev/dnsimple/apis/dnsimple-api/llms.txt) · [OpenAPI document](https://skmtc.dev/dnsimple/apis/dnsimple-api/revisions/faec8b49cc03?raw)