NAME

       notmuch-insert - add a message to the maildir and notmuch database

SYNOPSIS

       notmuch insert [options] [ +<tag>|-<tag> ... ]

DESCRIPTION

       notmuch  insert  reads  a  message  from  standard  input and delivers it into the maildir
       directory given by configuration option database.path, then incorporates the message  into
       the  notmuch  database.   It  is  an  alternative  to using a separate tool to deliver the
       message then running notmuch new afterwards.

       The new message will be tagged with the  tags  specified  by  the  new.tags  configuration
       option,  then  by operations specified on the command-line: tags prefixed by '+' are added
       while those prefixed by '-' are removed.

       If the new message is a duplicate of an existing message in  the  database  (it  has  same
       Message-ID),  it  will  be  added to the maildir folder and notmuch database, but the tags
       will not be changed.

       Option arguments must appear before any tag operation arguments.   Supported  options  for
       insert include

           --folder=<folder>

               Deliver  the  message to the specified folder, relative to the top-level directory
               given by the value of database.path.  The default is to deliver to  the  top-level
               directory.

           --create-folder

               Try  to  create  the  folder  named  by the --folder option, if it does not exist.
               Otherwise the folder must already exist for mail delivery to succeed.

EXIT STATUS

       This command returns exit status 0 if the message  was  successfully  added  to  the  mail
       directory, even if the message could not be indexed and added to the notmuch database.  In
       the latter case, a warning will be printed to standard error but the message file will  be
       left on disk.

       If the message could not be written to disk then a non-zero exit status is returned.

SEE ALSO

       notmuch(1),   notmuch-config(1),   notmuch-count(1),   notmuch-dump(1),  notmuch-hooks(5),
       notmuch-reply(1), notmuch-restore(1), notmuch-search(1), notmuch-search-terms(7), notmuch-
       show(1), notmuch-tag(1)