Artist, I'm relatively new at this but I've found out quite a bit about PDF::API2. The short answer to your question can be found here: http://groups.yahoo.com/group/perl-text-pdf-modules/message/1042

The idea behind an annotation object is to create a rectangle that is a 'hot zone' that turns the mouse pointer into a 'clickable finger' when hovering over it.

Hope this example (from the author of PDF::API2) will help you in creating hyper links. BTW, you can create links to URL's and to other pages in the PDF document.

-Mercutio_viz

Edit by castaway - linkified url, formatting