---
title: "Record a WordPress signup once"
method: PUT
path: "/subscribers/wordpress-signup-requests/{requestId}"
tags: ["Word Press Signup Request Resource"]
---

# Record a WordPress signup once

`PUT /subscribers/wordpress-signup-requests/{requestId}`

## Request

- Base URL: `https://api.maildroppa.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.maildroppa.com/subscribers/wordpress-signup-requests/{requestId}`
- Auth: API key in header `X-API-Key`

Same account, request ID and body return the original result. Changed data returns 409; submissions older than 24 hours return 410. Uses the account default signup flow.

## Path parameters

- `requestId` string, uuid, required

## Query parameters

- `placementId` string, uuid

## Headers

- `X-Maildroppa-Credential-Id` string, uuid

## Request body

- WordPressSignupRequestDto: A WordPress visitor signup after a successful contact-form submission. Replay the same request ID and body for up to 24 hours.
  - `submittedAtUtc` string, date-time
  - `signup` SubscriberOptInRequest: Starts double opt-in without mutating subscriber profile before confirmation.
    - `email` string
    - `firstName` string
    - `fields` FieldValueInput[]
      - `fieldId` string, uuid
      - `value` union: Strict typed subscriber field value accepted by write endpoints.
        - object: Text subscriber field value.
          - `kind` 'TEXT' | 'EMAIL' | 'NUMBER' | 'DATE' | 'BOOLEAN' | 'SINGLE_OPTION' | 'MULTI_OPTION', required: Typed value category used when reading or writing subscriber field values.
          - `text` string, required: Text value.
        - object: Email subscriber field value.
          - `kind` 'TEXT' | 'EMAIL' | 'NUMBER' | 'DATE' | 'BOOLEAN' | 'SINGLE_OPTION' | 'MULTI_OPTION', required: Typed value category used when reading or writing subscriber field values.
          - `text` string, required: Email value.
        - object: Number subscriber field value.
          - `kind` 'TEXT' | 'EMAIL' | 'NUMBER' | 'DATE' | 'BOOLEAN' | 'SINGLE_OPTION' | 'MULTI_OPTION', required: Typed value category used when reading or writing subscriber field values.
          - `number` number, required: Number value.
        - object: Date subscriber field value.
          - `kind` 'TEXT' | 'EMAIL' | 'NUMBER' | 'DATE' | 'BOOLEAN' | 'SINGLE_OPTION' | 'MULTI_OPTION', required: Typed value category used when reading or writing subscriber field values.
          - `date` string, date, required
        - object: Boolean subscriber field value.
          - `kind` 'TEXT' | 'EMAIL' | 'NUMBER' | 'DATE' | 'BOOLEAN' | 'SINGLE_OPTION' | 'MULTI_OPTION', required: Typed value category used when reading or writing subscriber field values.
          - `booleanValue` boolean, required: Boolean value.
        - object: Single-option subscriber field value.
          - `kind` 'TEXT' | 'EMAIL' | 'NUMBER' | 'DATE' | 'BOOLEAN' | 'SINGLE_OPTION' | 'MULTI_OPTION', required: Typed value category used when reading or writing subscriber field values.
          - `optionId` string, uuid, required
        - object: Multi-option subscriber field value.
          - `kind` 'TEXT' | 'EMAIL' | 'NUMBER' | 'DATE' | 'BOOLEAN' | 'SINGLE_OPTION' | 'MULTI_OPTION', required: Typed value category used when reading or writing subscriber field values.
          - `optionIds` string[], required: Selected option IDs.
    - `tags` string[]
    - `gdprAgreement` string
    - `consentSource` string
    - `topicIds` string[]: Active topic ids the confirmed subscriber joins. Missing means the tenant default topic.

## Other responses

- `400`: Bad Request
- `401`: Not Authorized
- `403`: Not Allowed
- `428`: Accept the customer agreements in the app before using API keys.

---

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