"new"

    my $bin = WWW::Pastebin::PastebinCom::Create->new;

Creates and returns a brand new WWW::Pastebin::PastebinCom::Create object. Does not take any arguments.

"paste"

    my $paste_uri = $bin->paste( text => 'Some text to paste' )
        or die $bin->error;

    $bin->paste(
        text    => 'Some text to paste',
        format  => 'perl', # perl syntax highlights
        expiry  => 'asap', # expire in 10 minutes
        private => 1,      # make the paste unlisted
        desc    => 'Some title',  # "title/name" for the paste
    ) or die $bin->error;

Pastes to the pastebin. On succcess returns the link to the newly-created paste (see also the overloaded "->paste_uri" method below). On failure returns "undef" or an empty list, depending on the context, and the human-readable error message will be available via the "->error" method. Takes arguments as key/value pairs. Argument "text" is mandatory, the rest are optional. Possible arguments are as follows:

"text"

    $bin->paste(
        text    => 'Some text to paste',
    ) or die $bin->error;

Mandatory. Takes a string as a value that contains the text to paste.

"private"

    $bin->paste(
        text    => 'Some text to paste',
        private => 1,      # make the paste unlisted
    ) or die $bin->error;

Optional. This really should be named "unlisted", but for compatibility with old code is still named "private". Takes true or value as a value. If set to a true value, the paste will be "unlisted" (i.e. people will be able to access them if they have a link, but the paste will not be announced on the pastebin.com home page), otherwise the paste will be public and listed on the home page. To make private pastes, you need to be logged in; use WWW::Pastebin::PastebinCom::API if you need that feature. Defaults to: 1 (make pastes unlisted).

"desc"

    $bin->paste(
        text    => 'Some text to paste',
        desc    => '',     # no "title/name" for the paste
    ) or die $bin->error;

Optional. Takes a string as a value that specifies the title/name for the paste. If this string is longer than 60 characters, it will be truncated and "..." will be appended to the end of it. By default is not specified.

"expiry"

    $bin->paste(
        text    => 'Some text to paste',
        expiry  => 'm',    # expire after a month
    ) or die $bin->error;

Optional. Takes an expiry code as a value that specifies when the paste should expire. Defaults to: "m" (expire after a month). Valid expiry codes are as follows (there are multiple possible codes for each duration; they are equivalent):

    # Expire after 10 Minutes
    10m
    m10
    asap

    # Expire after 1 Hour
    h
    1h

    # Expire after 1 Day
    d
    1d
    soon

    # Expire after 1 Week
    w
    1w
    awhile

    # Expire after 2 weeks
    2w
    w2

    # Expire after 1 Month
    1m
    m
    m1
    eventually

    # Never expire
    n
    never

"format"

    $bin->paste(
        text    => 'Some text to paste',
        format  => 'C++ (with QT extensions)',
    ) or die $bin->error;

Optional. Takes a format code as a value that specifies the paste text format (what syntax highlights to use). Defaults to: "none" (no syntax highlights). Possible values are as follows; they are case-insensitive:

    None
    Bash
    C
    C#
    C++
    CSS
    HTML
    HTML 5
    Java
    JavaScript
    Lua
    None
    Objective C
    Perl
    PHP
    Python
    Rails
    4CS
    6502 ACME Cross Assembler
    6502 Kick Assembler
    6502 TASM/64TASS
    ABAP
    ActionScript
    ActionScript 3
    Ada
    ALGOL 68
    Apache Log
    AppleScript
    APT Sources
    ARM
    ASM (NASM)
    ASP
    Asymptote
    autoconf
    Autohotkey
    AutoIt
    Avisynth
    Awk
    BASCOM AVR
    Bash
    Basic4GL
    BibTeX
    Blitz Basic
    BNF
    BOO
    BrainFuck
    C
    C for Macs
    C Intermediate Language
    C#
    C++
    C++ (with QT extensions)
    C: Loadrunner
    CAD DCL
    CAD Lisp
    CFDG
    ChaiScript
    Clojure
    Clone C
    Clone C++
    CMake
    COBOL
    CoffeeScript
    ColdFusion
    CSS
    Cuesheet
    D
    DCL
    DCPU-16
    DCS
    Delphi
    Delphi Prism (Oxygene)
    Diff
    DIV
    DOS
    DOT
    E
    ECMAScript
    Eiffel
    Email
    EPC
    Erlang
    F#
    Falcon
    FO Language
    Formula One
    Fortran
    FreeBasic
    FreeSWITCH
    GAMBAS
    Game Maker
    GDB
    Genero
    Genie
    GetText
    Go
    Groovy
    GwBasic
    Haskell
    Haxe
    HicEst
    HQ9 Plus
    HTML
    HTML 5
    Icon
    IDL
    INI file
    Inno Script
    INTERCAL
    IO
    J
    Java
    Java 5
    JavaScript
    jQuery

"error"

    $bin->paste( text => 'Some text to paste' )
        or die $bin->error;

If an error occurs during pasting, the "->paste" method will return an "undef" or an empty list, depending on the context, and the human-readable error message will be available via the "->error" method.

"paste_uri"

    $bin->paste( text => 'Some text to paste' )
        or die $bin->error;

    print "Your paste is at " . $bin->paste_uri . "\n";
    print "Your paste is at $bin\n";

Takes no arguments. Will return the link to the newly-created paste, after a successful call to "->paste". This method is overloaded for string interpolation, meaning you can simply interpolate the "WWW::Pastebin::PastebinCom::Create" object in a string to insert the link to the paste.