# Method Protocols.LysKOM.Session()->create_text()

Method create_text

  ``object` create_text(`string` `subject`, `string` `body`, `mapping` `options`)`
  ``object` create_text(`string` `subject`, `string` `body`, `mapping` `options`, `function`(:`void`) `callback`, `mixed` ... `extra`)`

Description

  Creates a new text.

  if `callback` is given, the function will be called when the text has been created, with the text as first argument. Otherwise, the new text is returned.

  `options` is a mapping that may contain:

  ``"recpt"` : `Conference`|`array`(`Conference`)` | recipient conferences.
  ``"cc"` : `Conference`|`array`(`Conference`)` | cc-recipient conferences.
  ``"bcc"` : `Conference`|`array`(`Conference`)` | bcc-recipient conferences*.
  ``"comm_to"` : `Text`|`array`(`Text`)` | The text(s) to be commented.
  ``"foot_to"` : `Text`|`array`(`Text`)` | The text(s) to be footnoted.
  ``"anonymous"` : `bool`` | send text anonymously.
  ``"aux_items"` : `array`(`AuxItemInput`)` | AuxItems you want to set for the text*.

Note

  The items above marked with '*' are only available on protocol 10 servers. A LysKOM error will be thrown if the call fails.

See also

  `Conference.create_text()`, `Text.comment()`, `Text.footnote()`