# Create a redirect rule

Creates a new redirect rule in your organization.

The fromUrl is normalized on creation: query parameters and hash fragments are stripped, the hostname is lowercased, and trailing slashes are removed. The fromUrl hostname must match the Help Center's configured custom domain.

The target article or collection must exist and have a resolvable URL (i.e., a published translation with a slug).

### Request Body

Required attributes:
- helpCenterId - The ID of the help center this rule belongs to
- locale - Locale code used to resolve the target translation
- fromUrl - The full absolute URL to redirect from (must match the help center's custom domain)
- targetType - "article" or "collection"
- targetId - The ID of the target article or collection

### Response

Returns the created redirect rule object.

### Errors

- 400 - Invalid request data, fromUrl does not match custom domain, or target not found

Endpoint: POST /v2/help_center/redirect_rules
Version: 2026-01-01.nova
Security: bearerAuth

## Header parameters:

  - `Featurebase-Version` (string)
    API version for this request. Defaults to your organization's configured API version if not specified.
    Example: "2026-01-01.nova"

## Request fields (application/json):

  - `helpCenterId` (string, required)
    Help center identifier this redirect rule belongs to
    Example: "ox6qrqprmsuqaunj"

  - `locale` (string, required)
    Locale code for the redirect rule. Used to resolve the target article/collection translation.
    Enum: "bn", "bs", "pt-BR", "bg", "ca", "hr", "cs", "da", "nl", "en", "et", "fi", "fr", "de", "el", "hi", "hu", "id", "it", "ja", "ko", "lv", "lt", "ms", "mn", "nb", "pl", "pt", "ro", "ru", "sr", "zh-CN", "sk", "sl", "es", "sw", "sv", "th", "zh-TW", "tr", "uk", "vi"

  - `fromUrl` (string, required)
    Full absolute URL to redirect from. Must use http or https protocol. Query parameters and hash fragments are stripped during normalization. The hostname must match the Help Center custom domain.
    Example: "https://help.example.com/en/old/getting-started"

  - `targetType` (string, required)
    Type of content the redirect points to
    Enum: "article", "collection"

  - `targetId` (string, required)
    ID of the target article or collection
    Example: "10021362"

## Response 201 fields (application/json):

  - `object` (string, required)
    Object type identifier
    Enum: "redirect_rule"

  - `id` (string, required)
    Redirect rule unique identifier
    Example: "507f1f77bcf86cd799439011"

  - `helpCenterId` (string, required)
    Help center identifier
    Example: "ox6qrqprmsuqaunj"

  - `locale` (string, required)
    Locale code for the redirect rule
    Enum: "bn", "bs", "pt-BR", "bg", "ca", "hr", "cs", "da", "nl", "en", "et", "fi", "fr", "de", "el", "hi", "hu", "id", "it", "ja", "ko", "lv", "lt", "ms", "mn", "nb", "pl", "pt", "ro", "ru", "sr", "zh-CN", "sk", "sl", "es", "sw", "sv", "th", "zh-TW", "tr", "uk", "vi"

  - `fromUrl` (string, required)
    Canonical source URL being redirected from (query and hash stripped)
    Example: "https://help.example.com/en/old/getting-started"

  - `targetType` (string, required)
    Type of content the redirect points to
    Enum: "article", "collection"

  - `targetId` (string, required)
    Target article or collection ID
    Example: "1234567"

  - `createdAt` (string, required)
    ISO 8601 timestamp when created
    Example: "2026-02-11T12:00:00.000Z"

  - `updatedAt` (string, required)
    ISO 8601 timestamp when last updated
    Example: "2026-02-11T12:00:00.000Z"

## Response 400 fields (application/json):

  - `error` (object, required)

  - `error.type` (string, required)
    The type of error returned
    Enum: "invalid_request_error"

  - `error.code` (string, required)
    Machine-readable error code
    Enum: "invalid_request", "business_validation_error", "resource_not_found"

  - `error.message` (string, required)
    Human-readable error message
    Example: "An error occurred"

  - `error.param` (string)
    The parameter that caused the error (if applicable)
    Example: "id"

  - `error.status` (number, required)
    HTTP status code
    Enum: 400