``` my $linkedin = Net::Linkedin::OAuth2->new( key => 'your-app-key', secret => 'your-app-secret');

get authorization url({ redirect_uri =>
    'http://localhost:3000/user/linkedin', scope =>
    ['r_basicprofile','rw_groups','r_emailaddress']})
    # scope is an array of permissions that your app requires, see
    http://developer.linkedin.com/documents/authentication#granting for
    more details, this field is optional

    my $authorization_code_url = $linkedin->authorization_code_url(
        redirect_uri => 'url_of_your_app_to_intercept_success',
        scope    => ['r_basicprofile','rw_groups','r_emailaddress'] );

    # convert code response to an access token # redirect_uri is the url
    where you will check for the parameter code.  # param('code') is the
    parameter 'code' that you will get after the user authorizes your app
    and gets redirected to the redirect_uri (callback) page.

    my $token_object = $linkedin->get_access_token(
         authorization_code => param('code'),      redirect_uri =>
    'your-app-redirect-url-or-callback' );

    # use the new token to request user information

    my $result = $linkedin->request(      url    =>
    'https://api.linkedin.com/v1/people/~:(id,formatted-name,picture-url,email-address)?format=json',
         token  => $token_object->{access_token} );

    # we have the email address              if ($result->{emailAddress}) {
                # ...  }

    # Or here is an entire login logic or recipe:

            my $linkedin = Net::Linkedin::OAuth2->new( key => 'your-app-key',
                                               secret => 'your-app-secret');

            # catch the code param and try to convert it into an access_token and get the email address
            if (param('code')) {

                my $token_object = $linkedin->get_access_token(
                        authorization_code => param('code'),
                        # has to be the same redirect_uri you specified in the code before
                        redirect_uri =>       'your-app-redirect-uri-or-callback-url'
                );

                my $result = $linkedin->request(
                    url    => 'https://api.linkedin.com/v1/people/~:(id,formatted-name,picture-url,email-address)?format=json',
                            token  => $token_object->{access_token} );

                    if ($result->{emailAddress}) {
                            # we have the email address, authenticate the user and redirect somewhere..
                            # ....

                            return;
                    } else {
                            # we did not get an email address
                            # redirect to try again?

                            return;
                    }

            }

            # get the url for permissions

            my $authorization_code_url = $linkedin->authorization_code_url(
                    # this field is required
                redirect_uri => 'your-app-redirect',
                       #array of permissions that your app requires, see http://developer.linkedin.com/documents/authentication#granting for more details, this field is optional
                scope    => ['r_basicprofile','rw_groups','r_emailaddress']
            );

            #redirect the user to get their permission
            redirect($authorization_code_url);

            # and catch an error back from linked in
            if (param('error')) {
                # handle the error
                # if the user denied, redirect to try again...
            }
```
=SEE ALSO
            http://developer.linkedin.com/documents