DIdigicert
records - primary - TXT

Creates a TXT record for a specific primary domain.

This endpoint creates a TXT record for a specific primary domain, enabling users to associate the domain with an IP address.</br></br>Key features include:</br></br>- Clear success messaging: Returns a 200 success code with a confirmation message indicating the successful completion of the requested action.</br>- Comprehensive error handling: Returns a 400 error code with a clear description when requests fail.</br>- Seamless record creation: Facilitates the creation of a TXT record in-line with the appropriate schema, ensuring smooth and efficient organization.</br>- Targeted data addition: Leverages the domainId parameter in the URL path to add a new TXT record to the specified domain, ensuring accurate and focused modifications for effective domain management.

post/domains/primary/{domainId}/records/TXT

Request

Path parameters

domainIdinteger required

Filters data by the domain's unique identifier.

Request body

typestring
namestring
createdTsstring date-time
modifiedTsstring date-time
systemFlagboolean
ttlinteger

Example request

{
  "type": "TXT",
  "name": "_dmarc",
  "createdTs": "2026-01-01T01:00:00.123456Z",
  "modifiedTs": "2026-01-01T01:00:00.123456Z",
  "ttl": 1800,
  "region": {
    "gtdLocationId": 1,
    "regionName": "NA_WEST",
    "regionLabel": "NA West"
  },
  "values": [
    {
      "id": 1,
      "value": "v=DMARC1; p=quarantine; rua=mailto:dmarc_agg@vali.email,mailto:dmarc@digicert.com",
      "syntax": "DMARC",
      "enabled": true,
      "sortOrder": 1
    }
  ]
}

Response

TXT record created successfully.

idinteger
typestring
namestring
createdTsstring date-time
modifiedTsstring date-time
systemFlagboolean
ttlinteger

Example response

{
  "id": 1,
  "type": "TXT",
  "name": "_dmarc",
  "createdTs": "2026-01-01T01:00:00.123456Z",
  "modifiedTs": "2026-01-01T01:00:00.123456Z",
  "ttl": 1800,
  "region": {
    "gtdLocationId": 1,
    "regionName": "NA_WEST",
    "regionLabel": "NA West"
  },
  "values": [
    {
      "id": 1,
      "value": "v=DMARC1; p=quarantine; rua=mailto:dmarc_agg@vali.email,mailto:dmarc@digicert.com",
      "syntax": "DMARC",
      "enabled": true,
      "sortOrder": 1
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.