> This page is optimized for agents. Use the linked Markdown pages and llms.txt indexes for related API content.

# Create ReservationAdditionalGuest entity.

> Creates a ReservationAdditionalGuest entity.

- Product: Reservation additional guests
- Section: ReservationAdditionalGuest
- Snapshot: Current
- Method: `POST`
- Path: `/api/reservation_additional_guests/`

## Query parameters

### `reservation`

Type: `number`  
Required: yes  

### `token`

Type: `string`  
Required: yes  

## Request body

Required: no  
Content types: `application/json`  

### `firstName`

Type: `string`  
Required: no  

### `surname`

Type: `string`  
Required: no  

### `surnamePrefix`

Type: `string`  
Required: no  

### `birthDate`

Type: `string`  
Required: no  

### `dateFrom`

Type: `string`  
Required: no  

### `dateTo`

Type: `string`  
Required: no  

### `ageGroupSpecification`

Type: `object`  
Required: no  

#### `id`

Type: `number`  
Required: no  

## Execute with TypeScript

Package: `@recranet/sdk`  

```ts
import { RecranetApiClient } from "@recranet/sdk";

const client = new RecranetApiClient({ apiKey: process.env.RECRANET_API_KEY! });

const result = await client.reservationAdditionalGuests.create({
  reservation: 0,
  token: "<token>",
});
```

## Execute with curl

```bash
curl -X POST "https://app.recranet.com/api/reservation_additional_guests/" \
    -H "X-Api-Key: $RECRANET_API_KEY" \
    --url-query "reservation=$RESERVATION" \
    --url-query "token=$TOKEN" \
    -H 'Content-Type: application/json' \
    -d '{}'
```

## Responses

### Response `200`

Category: success  

Successful response

#### `application/json`

##### Generated example

```json
{
  "id": 0,
  "dateFrom": "dateFrom",
  "dateTo": "dateTo",
  "created": "created",
  "ageGroupSpecificationDescription": "ageGroupSpecificationDescription",
  "name": "name",
  "firstName": "firstName",
  "surname": "surname",
  "surnamePrefix": "surnamePrefix",
  "birthDate": "birthDate",
  "modified": "modified",
  "ageGroupSpecification": {
    "id": 0,
    "type": "type",
    "description": "description",
    "excludedFromMaxNumOfPersons": true,
    "required": true,
    "relatedToCustomAccommodations": true,
    "locale": "locale",
    "priority": 0,
    "minNumOfPersons": 0,
    "maxNumOfPersons": 0,
    "minAge": 0,
    "maxAge": 0,
    "created": "created",
    "modified": "modified"
  }
}
```

##### Schema

###### ReservationAdditionalGuest

Type: `ReservationAdditionalGuest`  

###### `id`

Type: `number`  
Required: yes  

###### `firstName`

Type: `string`  
Required: no  

###### `surname`

Type: `string`  
Required: no  

###### `surnamePrefix`

Type: `string`  
Required: no  

###### `birthDate`

Type: `string`  
Format: `date-time`  
Required: no  

###### `dateFrom`

Type: `string`  
Format: `date-time`  
Required: yes  

###### `dateTo`

Type: `string`  
Format: `date-time`  
Required: yes  

###### `created`

Type: `string`  
Format: `date-time`  
Required: yes  

###### `modified`

Type: `string`  
Format: `date-time`  
Required: no  

###### `ageGroupSpecification`

Type: `AgeGroupSpecification`  
Required: no  

###### AgeGroupSpecification

Type: `AgeGroupSpecification`  

###### `id`

Type: `number`  
Required: yes  

###### `type`

Type: `string`  
Required: yes  

###### `description`

Type: `string`  
Required: yes  

###### `priority`

Type: `number`  
Required: no  

###### `excludedFromMaxNumOfPersons`

Type: `boolean`  
Required: yes  

###### `required`

Type: `boolean`  
Required: yes  
Deprecated: yes  

###### `minNumOfPersons`

Type: `number`  
Required: no  

###### `maxNumOfPersons`

Type: `number`  
Required: no  

###### `relatedToCustomAccommodations`

Type: `boolean`  
Required: yes  

###### `minAge`

Type: `number`  
Required: no  

###### `maxAge`

Type: `number`  
Required: no  

###### `locale`

Type: `string`  
Required: yes  

###### `created`

Type: `string`  
Format: `date-time`  
Required: no  

###### `modified`

Type: `string`  
Format: `date-time`  
Required: no  

###### `ageGroupSpecificationDescription`

Type: `string`  
Required: yes  

###### `name`

Type: `string`  
Required: yes  

### Response `400`

Category: client-error  

Bad request

#### `application/json`

##### Example

```json
{
  "statusCode": 400,
  "description": "Bad request",
  "errors": [
    "Bad request"
  ]
}
```

##### Schema

###### object

Type: `object`  

### Response `404`

Category: client-error  

Not found

#### `application/json`

##### Example

```json
{
  "statusCode": 404,
  "description": "Not found",
  "errors": [
    "Not found"
  ]
}
```

##### Schema

###### object

Type: `object`  

## Related representations

- [Human documentation](/reservation-additional-guests/methods/create/)
- [TypeScript Markdown](/reservation-additional-guests/methods/create.md?lang=typescript)
- [curl Markdown](/reservation-additional-guests/methods/create.md?lang=curl)
- [site llms.txt](/llms.txt)
- [product llms.txt](/reservation-additional-guests/llms.txt)
- [snapshot llms.txt](/reservation-additional-guests/llms.txt)