Zazzle
Create-‐a-‐Product
API
Guide
The
Zazzle
Create-‐a-‐Product
API
lets
you
generate
a
simple
link
that
dynamically
makes
a
custom
product
for
sale
in
your
Zazzle
Store
from
any
art,
photograph,
or
text
on
your
web
site.
The
Zazzle
Create-‐a-‐Product
API
takes
advantage
of
the
possibilities
offered
by
Zazzle
template
products.
A
template
product,
unlike
standard
Zazzle
products,
contains
placeholder
areas
that
allow
customers
to
determine
what
images
or
text
appear
there.
You
can
still
retain
quite
a
bit
of
design
control,
by
choosing
the
areas
you
allow
your
customers
to
modify,
the
size
of
the
design,
the
font
used
for
text,
and
other
aspects
of
the
product.
Your
customer
can
choose
what
appears
on
your
product,
and
you
get
the
royalty.
For
example,
if
you
run
a
Valentine’s
site,
you
can
create
a
t-‐shirt
with
your
company's
logo
on
the
back
of
the
shirt,
and
a
placeholder
for
the
user's
image
on
the
front,
with
a
border.
When
your
customer
selects
a
t-‐shirt
product
on
your
site,
she
can
then
upload
a
picture
to
your
site
and
click
a
link
or
button
to
automatically
create
a
t-‐shirt
product
on
Zazzle
with
her
picture
on
the
front
and
your
logo
on
the
back.
Template
Product
2
Templates Buffet
A
single
template
product
lets
your
buyers
see
their
designs
on
a
single
product.
Using
the
Create-‐
a-‐Product
API
Templates
Buffet
feature,
you
can
let
them
see
and
buy
their
designs
on
multiple
products
at
once.
Create
a
Store
Category
containing
a
variety
of
template
products
and
generate
a
Templates
Buffet
link
to
let
buyers
display
their
designs
and
text
on
all
the
products
at
once.
Continuing
the
above
Valentine
picture
example,
the
Templates
Buffet
feature
lets
your
buyers
see
their
picture
on
several
different
shirts,
mugs,
hats,
bags,
or
other
products
you
choose,
with
just
a
single
link
to
Zazzle.
Templates
Buffet
Before you Start…
Before
you
can
begin
to
use
the
Create-‐a-‐Product
API,
you
must:
• Open
a
Zazzle
Store
• Create
template
products
in
your
Store
• Accept
the
Create-‐A-‐Product
API
Partner
Program
Agreement
• Declare
the
domain(s)
hosting
your
content
3
Open a Store
To
use
the
Create-‐a-‐Product
API,
you
must
have
a
Zazzle
Store
containing
one
or
more
template
products.
If
you
don’t
have
a
Zazzle
Store
already,
open
a
free
Zazzle
Store
by
registering
on
Zazzle.com.
For
more
information
about
Zazzle
Stores
see
http://www.zazzle.com/sell/Store/create.
Create Template Products
For
instructions
on
how
to
create
template
products,
see
the
Creating
Template
Products
Instructions.
Accept the Create-A-Product API Partner Program Agreement
In
order
to
authorize
you
to
use
the
Create-‐A-‐Product
API,
you
need
to
accept
the
Create-‐A-‐Product
API
Partner
Program
Agreement.
1. Go
to
http://www.zazzle.com/api
2. Review
the
Create-‐A-‐Product
API
Partner
Program
Agreement.
3. Click
the
“I
Agree,
Continue”
button
at
the
bottom
of
the
page
You
will
be
taken
to
the
Declare
Your
Domains
page,
which
is
the
next
step
in
the
process.
Declare Your Domains and Ownership of Content
Once
you
have
created
template
products
in
your
Zazzle
Store,
and
accepted
the
Create-‐A-‐Product
API
Partner
Program
Agreement,
you
need
to
tell
Zazzle
from
where
the
content
you
plan
to
use
with
those
templates
will
be
coming.
All
you
have
to
do
is
enter
the
name
of
each
domain
you
intend
to
use
to
Store
your
content.
1. Go
to
your
Store’s
Declare
Your
Domains
page,
at:
http://www.zazzle.com/my/Store/associate/domains
.
4
Declare
Your
Domains
Page
2. Enter
the
name
of
one
domain
(e.g.,
mydomain.com)
you
intend
to
use
for
your
content
under
Add
a
Domain
and
click
the
Add
button.
3. Repeat
for
each
domain
you
intend
to
use.
4. Under
the
Ownership
of
Content
heading,
select
one
of
the
following:
o I
own
rights
to
the
content
that
will
be
passed
through
the
API.
This
content
will
be
placed
into
an
Image
Set
in
My
Account
when
passed
to
Zazzle.
o The
content
that
will
be
passed
through
the
API
belongs
to
the
users
who
will
link
from
my
site
(for
example:
a
photo
sharing
site).
This
content
will
be
placed
in
an
Image
Set
in
their
Zazzle
accounts
if
they
sign
up
for
Zazzle
after
using
the
API.
Note
that
if
the
user
were
to
place
an
order
at
a
later
date
using
this
content,
you
would
not
collect
royalty
income.
5. Click
Submit
and
you
are
done.
Generating your Create-a-Product Template link
Once
you
have
completed
the
above
steps,
you
are
ready
to
create
a
Template
Link
for
use
with
the
Create-‐a-‐Product
API.
A
Template
Link
is
a
simple
HTML
link
you
can
use
to
pass
content
on
your
Web
site
to
one
of
your
template
products
on
Zazzle.
Customers
on
your
site
can
use
your
designs
or
add
their
own
words
or
images
to
create
a
product
in
your
Zazzle
Store
simply
by
clicking
on
a
Template
Link
on
your
site.
Create
a
Template
Link
1. Go
to
the
Create-‐a-‐Product
API
page
at
http://www.zazzle.com/my/associate/create
5
Create
A
Template
Link
tab
on
Create-‐a-‐Product
API
page
2. Enter
your
Template
ID,
then
click
OK
o The
Template
ID
or
Product
ID,
is
the
unique
18-‐digit
number
which
appears
on
the
right
side
of
the
URL
for
your
product
and
also
the
lower
left
side
of
each
product
page.
For
example,
if
your
product’s
URL
is:
o http://www.zazzle.com/message_t_shirt-‐235301951217862963
o Your
Template
ID
would
be
“235301951217862963”.
Enter
only
the
numbers
and
click
OK.
3. Enter
placeholder
data
and
other
options
When
you
click
OK
more
steps
are
displayed.
If
your
template
product
is
setup
correctly,
then
entry
fields
for
each
template
object
on
your
product
will
appear.
You
can
then
enter
the
location
(URL)
of
an
image
from
your
website,
if
any,
and/or
text
you
would
like
displayed
on
your
product,
if
any.
If
there
are
other
template
fields
you
can
fill
them
in
as
well.
Also
you
can
decide
if
your
link
opens
the
product
in
the
Design
Tool
or
simply
as
a
product
for
sale
on
the
Product
Page,
and
if
the
user
can
personalize
your
product
by
making
further
changes
to
the
content
of
the
image
or
text
template
field.
6
Enter
Placeholder
data
and
other
options
4. Click
on
“Try
link
now”
to
launch
a
new
browser
tab
using
your
new
URL
as
your
customer
will
see
it.
You
can
also
copy
and
paste
your
new
URL
from
the
field.
Note
that
when
your
customer
clicks
your
Template
Link,
the
long
URL
you
see
here
disappears
and
is
replaced
in
the
browser
with
a
simple
URL
for
the
product.
All
information
on
the
original
linkover,
such
as
your
referral
ID,
will
be
captured
by
Zazzle.
Create
a
Templates
Buffet
You
can
use
the
Create-‐a-‐Product
API
to
do
for
an
entire
Store
Category
what
a
Template
Link
does
for
a
single
product.
Your
customers
can
see
your
design
or
text
appear
on
mouse
pads,
t-‐shirts,
greeting
cards,
and
any
other
template
products
you
add
to
that
Store
Category,
by
clicking
a
single
link.
One
click
creates
an
entire
Store
Category
of
complete
and
ready-‐to-‐purchase
Zazzle
products.
Creating
a
Templates
Buffet
is
almost
the
same
as
creating
a
Template
Link
for
a
single
product.
The
main
difference
is,
you
must
create
a
Store
Category
containing
more
than
one
template
product
like
the
one
used
by
the
Template
Link.
1. To
create
a
Templates
Buffet,
first
set
up
one
or
more
Store
Categories,
containing
template
products
for
each
product
type
you
want
to
sell.
Templates
Buffet
works
its
magic
on
entire
Store
Categories,
so
you
have
to
create
at
least
one
Store
Category
to
use
it.
When
creating
a
Store
Category
for
use
with
Templates
Buffet,
you
must
use
the
same
URL
parameter
name
for
the
placeholder
text
and
images
for
each
product
in
your
Store
Category.
For
more
information
on
creating
a
Store
Category,
see
the
Creating
and
Editing
Product
Categories
Help
Topic.
2. Then,
go
to
the
Create-‐a-‐Product
API
page
at
http://www.zazzle.com/my/associate/create
and
select
the
"Create
a
Templates
Buffet"
tab.
7
The
process
of
creating
a
Templates
Buffet
is
almost
the
same
as
creating
a
Template
Link,
except
that
you
don’t
even
have
to
know
the
ID
number
for
your
Store
Category
because
you
can
select
one
of
your
Store
Categories
using
a
menu.
Templates
Buffet
Setup
Tab
3. Select
a
default
Store
Category
from
your
Store
If
you
organized
your
Templates
Buffet
template
products
in
one
or
more
Store
Categories,
select
a
Store
Category
for
your
Templates
Buffet
here.
If
you
do
not
select
a
Store
Category
here,
all
template
products
in
your
Store
will
be
used
in
the
Templates
Buffet.
Grouping
template
products
containing
the
same
template
fields
results
in
more
successful
Templates
Buffet
products.
If
you
enter
placeholder
values
here,
they
override
the
placeholder
values
contained
in
your
template
products.
8
4. Setup
your
buffet
page
options.
We
recommend
simply
playing
with
these
options
using
the
Preview
in
a
new
window
button
to
see
what
they
do.
• Show
category
browser
Links
to
each
of
your
Store
Categories
are
displayed,
along
with
your
Templates
Buffet
products.
You
can
choose
to
Show
All
Categories
in
your
store,
or
just
the
specific
category
you
chose
above.
• Allow
personalization
Same
as
the
option
in
Template
Link:
allows
your
buyer
to
make
further
changes
to
the
content
of
the
image
or
text
template
field.
• Display
short
descriptions
You
can
choose
to
display
the
brief
descriptions
for
each
product
or
a
product
grid
without
descriptions.
• The
“Go
back”
link
appears
in
the
top
left
of
your
Store.
By
default
it
is
a
link
to
your
Zazzle
Store’s
home
page,
and
the
default
text
for
the
link
is,
“«
Go
back
to
[Storename]
Store”,
where
[Storename]
is
the
name
of
your
Store.
If
you
would
prefer
a
different
URL
or
different
text,
such
as
your
Web
site’s
URL,
you
can
make
the
change
here.
• When
a
thumbnail
is
clicked,
go
to:
When
your
customer
clicks
on
one
of
your
Templates
Buffet
products,
the
product
is
displayed
either
in
Product
Page
or
Design
Tool.
If
you
link
them
to
the
Design
Tool
the
user
is
more
likely
to
add
their
own
additional
customizations
prior
to
purchase.
• Click
“Preview
in
a
new
window…”
to
display
your
Templates
Buffet
products
in
a
new
browser
window.
You
can
still
make
changes
and
try
again.
5. Copy
the
link
to
your
Templates
Buffet!
Here
is
your
final
Templates
Buffet
link.
You
can
use
this
link
anywhere
you
might
use
an
HTML
link.
For
example,
you
can
associate
it
with
a
graphic,
with
any
text,
or
a
button.
Advanced Links
If
you
are
the
kind
of
person
who
likes
to
add
something
special
directly
in
the
code,
you
can
edit
your
Template
Link
or
Templates
Buffet
link
or
write
your
own
from
scratch.
Template Link
Here
is
a
sample
template
link
that
pulls
in
a
simple
heart
image:
9
http://www.zazzle.com/api/create/at-‐
238328456366539674?rf=238328456366539674&ax=linkover&pd=235470322923515588&fwd=pr
oductpage&ed=true&coverimage=http%3A%2F%2Fwww.moxiemarketing.net%2Fheart_image.png
These
are
the
parameters
on
this
link
if
you
wish
to
edit
them
directly:
Parameter
Definition
and
values
rf
Your
associate
ID
ax
Type
of
API
request.
For
this
type
of
link
this
should
always
be
linkover
pd
The
ID
of
the
product
to
which
you
are
linking.
fwd
Specifies
which
page
will
display
for
the
product.
May
be
productpage
or
designtool.
ed
Specifies
whether
or
not
the
buyer
can
customize
the
product.
May
be
true
or
false.
coverimage
This
parameter
name
should
be
the
URL
parameter
name
you
specified
when
you
setup
your
template
product.
The
value
must
be
the
URL
Encoded
link
to
the
image
on
your
web
site.
The
default
is
image1,
but
in
this
example
it
is
coverimage.
If
you
were
sending
text
it
must
also
be
URL
encoded
Templates Buffet Link
Here
is
a
sample
Templates
Buffet
link
which
pulls
in
a
simple
heart
image
http://www.zazzle.com/api/create/at-‐
238328456366539674?rf=238328456366539674&ax=designblast&cg=196027207141086695&ed=t
rue&br=true&rcg=0&ds=true&continueUrl=http%3A%2F%2Fwww.zazzle.com%2Ftemplates&rut=G
o%20back%20to%20templates's%20store&fwd=productpage&coverimage=http%3A%2F%2Fwww.
moxiemarketing.net%2Fheart_image.png
Parameter
Definition
and
values
rf
Your
associate
ID
ax
Type
of
API
request.
For
Templates
Buffet
this
should
be
designblast
cg
The
ID
of
the
Store
Category
to
which
you
are
linking.
You
can
get
this
by
navigating
to
the
category
in
your
Store
and
copying
the
number
at
end
of
the
URL.
For
example,
this
URL
http://www.zazzle.com/templates/gifts?cg=196027207141086695,
means
the
category
ID
is
196027207141086695
ed
Specifies
whether
or
not
the
buyer
can
customize
the
product.
May
be
true
or
false.
eds
If
set
to
Inline,
then
the
fields
for
a
customer
to
personalize
your
product
will
display
in
the
left
side
navigation
of
the
page.
If
set
to
Dialog
(or
omitted),
then
a
Personalize
These
Products
button
will
appear
at
the
top
of
the
page.
Clicking
this
button
will
pop-‐up
a
dialog
box
in
which
customers
can
personalize
their
template
products.
br
Display
a
left
side
navigation
menu
with
links
to
your
Store
Categories.
May
be
10
true
or
false.
rcg
Which
category
to
display
in
the
above
left
side
navigation.
If
this
parameter
is
0
or
omitted,
then
all
categories
in
your
store
will
display.
If
a
category
ID
is
specified,
then
only
that
category
and
its
sub-‐categories
will
display.
ds
Display
short
descriptions.
May
be
true
or
false.
continueURL
The
URL
for
your
site.
Must
be
URL
encoded.
rut
Title
of
your
URL.
Must
be
URL
encoded.
fwd
Specifies
which
page
will
display
for
when
the
user
selects
a
product
in
the
Templates
Buffet.
May
be
productpage
or
designtool.
coverimage
This
parameter
name
should
be
the
URL
parameter
name
you
specified
when
you
setup
your
template
product.
The
value
must
be
the
URL
Encoded
link
to
the
image
on
your
web
site.
The
default
is
image1,
but
in
this
example
it
is
coverimage.
If
you
were
sending
text
it
must
also
be
URL
encoded
URL Encoding
The
characters
allowed
in
URLs
are
a
limited
subset
of
all
the
characters
you
can
type.
Some
characters
are
reserved
for
special
uses.
The
URLs
to
product
images
on
your
website
that
you
use
with
the
Create-‐a-‐Product
API
must
be
encoded
to
be
interpreted
correctly
by
browsers.
This
is
done
automatically
when
you
generate
a
link
using
the
Templates
API
interface.
If
you
generate
your
URL
by
hand,
you
must
encode
your
URL
when
you
are
finished.
You
can
encode
your
URL
by
hand,
following
rules
available
on
many
web
sites,
but
we
recommend
you
use
one
of
the
many
free
URL
encoders
on
the
Web,
such
as:
http://meyerweb.com/eric/tools/dencoder/
or
http://coderstoolbox.net/string/
Use
these
sites
at
your
own
risk
and
check
their
output
carefully.
You
can
learn
more
about
URL
encoding
on
numerous
sites
on
the
Web.
Image Security
If
you
are
concerned
with
the
security
of
your
images,
you
can
put
them
in
a
location
on
your
web
site
that
is
only
accessible
to
Zazzle.
To
do
this,
use
a
reverse
lookup
on
your
web
server
that
grants
access
only
to
rlv.zazzle.com
Referrals and reporting
For
each
sale
generated
by
a
template
link
or
Templates
Buffet
link,
you
will
receive
your
selected
product
royalty
plus
the
15%
or
more
associate
referral
fee
received
for
every
qualified
sale.
11
You
will
be
able
to
track
the
number
of
linkovers
and
the
number
of
sales
of
each
product
template
using
Zazzle's
reporting
tools.
You
can
track
the
number
of
links
on
the
linkover
History
page
at
http://www.zazzle.com/my/associate/linkoverhistory.
This
page
shows
you
the
number
of
links
you
received
each
day.
You
can
track
the
number
of
times
each
of
your
product
templates
is
used
and
purchased
on
the
Referral
by
Product
page.
To
track
your
total
earnings,
go
to
the
Earnings
Summary
page
at
https://www.zazzle.com/my/earnings/summary.
